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Preface 


Many computer users are content to program in BASIC for all of 
their computing lives. A large number of others are eager to find out 
more about computing and their computer than the use of BASIC 
can provide them. Few, however, seem to make much progress to 
the use of machine code, and I think this is so because so many books 
which deal with machine code seem to assume that the reader is 
already familiar with the ideas and jargon words of machine code. 
Also, these books tend to treat machine code as a study in itself, 
leaving the reader with little clue to the application of machine code 
to his or her own computer. 

This book has two main aims. One is to introduce the 
Spectrum owner to some of the details of how the Spectrum 
works, so allowing for more effective programming even without 
delving into machine code. The second aim is to introduce the speed 
and power of machine code by means of simple examples. I must 
emphasise the word ‘introduce’. No single book can tell all about 
machine code, and all I can claim is to give you, the reader, enough 
information to get started. Getting started means being able to write 
short machine code routines, understand such routines printed in 
magazines, and generally make more effective use of your 
Spectrum. It also means that you will be able to make effective 
use of books on machine code programming such as those which are 
listed in Appendix A ~ these are the books which are your entry to 
much more advanced work. From there, complete mastery of 
machine code programming is just a short step. 

Together, understanding the operating system of the computer 
and having the ability to work in machine code can open up an 
entirely new world of computing to you. Understanding the 
Operating system allows you to do things like renumbering program 
lines, changing PRINT instructions to LPRINT with one 
command, altering the key-press BEEP, or printing out a list of all 


Chapter One 
ROM, RAM, Bytes 
and Bits 


One of the discouraging things about digging below the surface of 
BASIC is the number of jargon words that you encounter. The 
writers of many books on computing seem to assume that the reader 
has an electronics background, so that it’s not surprising that 
readers with such a background slip into the jargon quite easily. I 
shall assume that you, the reader, have no such background 
knowledge, and that all Icanask you to call upon is some experience 
of computing in BASIC witha Spectrum, preferably by writing your 
own BASIC programs. We shall start at the correct place, at the 
beginning. Since I don’t want to interrupt explanations by having to 
include mathematical or other technical details, I have referred to 
these, where relevant, in the Appendices, so that you can take them 
or leave them according to your feelings about them. 

In the beginning, then, there is memory. A unit of memory, as far 
as we are concerned, is just an electrical circuit that acts like a switch. 
You walk into a room, switch a light on, and you never think of it as 
remarkable that the light stays on until you switch it off. You never 
tell your friends, in reverent tones, that the light circuit contains a 
memory, and yet each memory unit of a computer isno more thana 
very small variety of switch which can be turned on or off and which 
will then stay that way until itis used again. One unit of memory like 
this is called a bit — the name is a contraction of binary digit. 

Now let’s stick with the idea of a switch, because it is so useful. 
Suppose that we wanted to signal with electrical circuits and 
switches. We could use a circuit like the one in Fig. 1.1. When the 
switch is on, the light is also on, and we take this as meaning YES. 
Turn the switch off, and the light goes out; we could take this to 
mean NO. You could use any other two meanings that you wanted, 
so long as there are only two. Things improve if you use two 
switches, two lights, two lines, as in Fig. 1.2. Now four different 
combinations are possible: (a) both off (b) A on, B off (c) B on, A off, 
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think of zero as meaning ‘switch off’, and | as meaning ‘switch on’, so 
that 256 different numbers could be signalled using eight switches, 
by thinking of the switch positions as digits, ( for off, | for on. This 
group of eight is called a byte, and this is why the number 256 is 
encountered so much in computing. Why a group of eight? It just 
happened: the early calculators were able to work with four bits ata 
time, and the step up to eight bits has lasted for quite a long while, 
Sixteen-bit machines are still not very common. 

The way the bits in a byte are arranged so as to indicate a number 
is along the same lines as we use to indicate numbers normally. 
When you write a number such as 256, the 6 means six units, the 5is 
written to the immediate left of the 6 and means the number of tens, 
and the two is written one more place to the left, and is the number of 
hundreds. These places indicate the importance or significance of a 
digit (see Fig. 1.3). The 6 in 256 is called the ‘least significant digit’, 
the 2 is the ‘most significant digit’. Change the 6 to 7, and the change 
is one part in 256. Change the 2 to 3 and the change is one hundred 
parts in 256 — much more important. 


2 5 3 a denary (decimal) number 
most significant least significant 
digit digit 


| 7) 1 a binary number 


Fig. 1.3. Significance of digits. Our numbering system, unlike the old Roman 
system, uses the place of a digit to indicate its significance or importance. 


Having looked at bits and bytes briefly, it’s time to go back fora 
moment to the idea of memory asa set of switches. As it happens, we 
need two types of memory. One type must be permanent, like 
mechanical switches or fixed connections, because it is used to hold 
number-coded instructions that operate the computer. This is the 
type of memory which is called ROM, the letters meaning Read- 
Only Memory. The ROM is the most important part of your 
computer because it contains the instructions which make the 
computer carry out all of its actions. When you write a program for 
yourself, you store another set of number-coded instructions in a 
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part of memory that you will want to be able to use over and over 
again. This is a different type of memory which can be ‘written’ or 
‘read’, and if we were logical about it we would call it RwWM, 
standing for read-write memory. Unfortunately, we’re not very 
logical about it, and we call it RAM (Random-Access Memory), 
which was a name used in the very early days of computing to 
distinguish this type of memory from one which operated in a 
different way. We're stuck with the name RAM now, so we'll have to 


make the best of it! 


All done by numbers 


Now let’s get back to the bytes. We saw that a byte, which isa group 
of eight bits, can consist of any of 256 different arrangements of 
these bits, and that the most useful way of using these arrangements 
is to make each one represent a number in whatis called binary code. 
The numbers are ) to 255 (nor 1 to 256, because we need a code for 
zero), and each byte of the 16,384 bytes of RAM in your Spectrum 
16K can store a number in this range. 

Numbers by themselves are not of much use, and we wouldn't find 
a computer particularly useful if it could deal only with numbers 
between @ and 255, so we make use of these numbers as codes. Just 
as your Spectrum uses each key to do several different actions, each 
number code can be used to mean several different things. If you 
have worked with some BASIC programming, you will know that 
each letter of the alphabet and each of the digits @ to 9, and each of 
the punctuation marks is coded as a number between 32 (which is the 
space) and 127 (which is the copyright sign on Spectrum). That 
leaves us with a large number of code numbers to use for other 
purposes such as graphics characters, and Spectrum, like all other 
small computers, uses most of the numbers also as codes for actions 
When, for example, you press the key which is marked PRINT, 
what is placed in the RAM memory of your Spectrum is not the 
sequence of ASCII number codes for PRINT, which would be 
80,82,73,78,84, needing five bytes; but one single byte, 245. This 
single byte is called a ‘token’, and it can be used by the computer in 
two ways. One is to locate the actual characters which make up the 
word PRINT. These are stored in ASCII number-code form in the 
ROM, because they won’t be changed (you don’t want the word 
PERPLEXING to appear when you press the PRINT key!) and so 
that they don’t take up space in your RAM. The other use of the 
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token is to locate a set of instructions, also in coded form in the 
ROM, which will cause the action of printing (on the screen) to be 
carried out. These codes are the ones that we refer to as ‘machine 
code’, because they directly control what the machine does. 


Practical interlude 
As an aid to digestion, try a short program. This one (Fig. 1.4) is 


designed to reveal these ‘keywords’ that are stored in the ROM, and 
it makes use of the BASIC instruction, PEEK. PEEK has to he 


19 PRINT 150;" "5: FOR n = 15 TO 516 

2@ LET k = PEEK n 

30 IF k< = 127 THEN PRINT CHR$ k; 

4 IF k > = 128 THEN PRINT CHR$ (k - 128): 
PRINT n;" ae 

50 NEXT n 


Fig. 1.4. ABASIC program to PEEK at words stored in the ROM 


followed by a number or a number variable, and it means: ‘find the 
byte stored at this address number’. The groups of eight units of 
memory in your Spectrum are numbers from zero upwards, one 
number for cach byte whether it is ROM or RAM, and because this 
is so much like the numbering of houses in a road, we refer to the 
numbers as addresses. The action of PEEK is to find out what 
number, which must be between @ and 255, is stored at each address, 
and the Spectrum automatically converts the binary-coded numbers 
into ordinary (decimal, or more correctly denary) form. By using 
CHR3$, we can print the character whose code is the number we have 
PEEKed at. So far, so good. The program allocates ‘n’ as an address 
number, and then checks that PEEK n is less than 128 - in other 
words, that it is a character in ASCII code. If it is, it is printed. 
Now the reason that we need the check is that the last character in 
each set of words or word is stored with a different coding. The 
number that is PEEKed for the last character is 128 + the ASCII 
code, rather than just the ASCII code. For example, the first three 
locations which the program PEEKs at, with addresses 159, 151, 
and 152, contain the numbers 82, 79 and 196. The number 82 is the 
ASCII code for R, 79 is N, and 196—128 = 68, which is the ASCII 
code for D, so this is where the word RND is stored. Why fiddle the 
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scale maps, which show us main routes between towns but don’t 
show side roads or town streets. A block diagram is enough to show 
us the main paths for signals in the computer, without the sort of 
confusing detail that you need if you want to show exactly what 
electrical connections are made. 

Two of the blocks have already been introduced to you, ROM and 
RAM. ROM is the memory that can’t be changed; it contains all of 
the essential instructions, along with keywords and token numbers, 
that are needed to make the computer work. The RAM is used to 
contain your programs and a lot more besides, but we’ll go into that 


later. 
plastic block 


enclosing circuit 


20 pins this side 


marking for 
pin number 1 


Fig. 1.6. The Z-80A MPU. The actual working portion is smaller than a 
fingernail, and the larger plastic case (52 mm long, 14 mm wide) makes it 
easier to work with. 


The block marked MPU is a particularly important one. MPU 
means Microprocessor Unit (although some block diagrams use the 
letters CPU, meaning Central Processing Unit), and that’s the main 
‘doing’ unit in the system. Unit is a well-chosen name in this case, 
because the MPU is just a single plug-in chunk, one of these silicon 
chips you read about, encased in a slab of black plastic, and 
provided with 40 connecting pins arranged in two rows of 20, as Fig. 
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Loading and storing are two very important actions of the MPU, 
but there are several others. One set of actions is the arithmetic set. 
Contary to what you might expect, these consist of addition and 
subtraction only, and of no more than two-byte numbers either. 
How does the computer carry out arithmetic with larger numbers, 
numbers with fractions, how does it carry out multiplication, 
division, raising to powers, logarithms, sines and cosines? The 
answer is by machine code programming that is contained in the 
ROM. If these programs were not there, you would have to write 
your own, and a BASIC program for carrying out multiplication, 
using only addition, would be long and tedious, not a pretty sight. 

There’s also the logic set. MPU logic is, like all MPU actions, 
simple and obeys rigorous rules. Logic actions compare the bits of 
two bytes, and produce an ‘answer’ which depends on these bit 
values (@ or 1) and on the logic rule that is being used. The three logic 
rules are called AND, OR, and XOR, and Fig. 1.8 shows how they 
are applied. 

Another set of actions is called the jump set. A jump means a 
change of address, rather like the action of a GOTO in BASIC, and 
it’s the way in which the MPU carries out its decision steps. Just as 
you can program in BASIC: 


199 IF a= 36 THEN GOTO 1650 


so the MPU can be made to carry out an instruction at an entirely 
different address from the normal one, which would be the next 
address number. The MPU is a programmed device, meaning that it 
carries out each action as a result of being fed with an instruction 
byte which has been stored in the memory. Normally when the MPU 
is fed with an instruction from an address somewhere (usually in 
ROM), it carries out the instruction and then ‘reads’ the instruction 
byte that is stored in the next address up. A jump instruction would 
prevent this from happening, and would instead cause the MPU to 
read another address, one that was specified in the jump instruction. 
This jump action can be made to depend on some previous action, 
such as a zero, Or positive, or negative answer to a subtraction, 
addition or comparison. 

That isn’t a great list, but the actions which I’ve omitted are not 
very important, nor very different from the ones in the list. What I 
want to emphasise is that the magical microprocessor isn’t such a 
very smart device. What makes it so vital to the computer is that it 
can be made to carry out its actions very quickly, and each action is 
completely controlled by programming, sending it electrical signals. 
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These signals are sent to eight pins, called the data pins, of the MPU 

and, as you will have realised, these eight pins correspond to the 

eight bits ofa binary-coded byte. Each byte of memory will therefore 

be able to affect the microprocessor by sharing its electrical signals 
with the MPU. Descriptions in words like this take too long to write 
more than once, so we speak of reading and writing, always from the 
point of view of the MPU. Reading means that a byte of memory is 
connected to the MPU so that each | bit causes a | signal on a data 
pin, and each @ bit causes a signal on the corresponding data pin. 
Just as reading a paper or listening to a tape doesn’t destroy what is 
written or recorded there, reading a memory doesn’t change the 
memory in any way, and nothing is taken out. The opposite process 
of writing does, however, change memory. Like recording a tape, 
writing obliterates whatever existed there before, so that when the 
MPU writes a byte to an address in the memory, whatever was 
stored at that address previously is there no more and has been 
replaced by the new byte. This is why it is so easy to write new 
BASIC lines replacing old ones at the same line number. 


Pick a number, any number ... 


Do you really write programs in BASIC? It might sound like a silly 
question, but it’s a serious one. The actual work of a program is done 
by coded instructions to the MPU and so far you don’t write any of 
these. All you do is to select from a menu of choices that we call the 
BASIC keywords, and arrange them in the order that you hope will 
produce the correct results. Our choice is limited to the keywords 
that are designed into the computer in the ROM. We can’t alter the 
ROM, and if we want to carry out an action that is not provided for 
in the ROM, we must either try to make it work by combining 
BASIC commands, or operate directly with machine code on the 
MPU. It’s like the difference between talking of a ‘motorised vehicle 
with a capacity for transporting more than eight persons’, and a 
‘bus’. When you have to carry out actions with only a limited 
number of commands, the result can be clumsy, especially if each 
command isa collection of other commands. Direct action is quick, 
but it can be difficult. The ‘direct-action’ that I’m talking about is 
machine code, and a lot of this book will be devoted to 
understanding this ‘language’ which is difficult just because it’s 
simple! 

Take a situation to illustrate this paradox. Suppose you want a 


Ky. You ouldn’t tel] 
c are beyond its 
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until a pail 
down. Fill 
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be carried out 
ig, it won't be 
cify how much 
bricks will be 


Chapter Two 
Digging inside Spectrum 


Don’t take the title too literally, you don’t need to open the case! 
What I mean is that in this chapter we are going to look at how the 
Spectrum is organised to load and run BASIC programs, and we 
shall in the course of this discover the meanings of some of the 
numbers and the cryptic titles that occur in Chapter 25 of the 
Spectrum manual. 

Let’s start with a simplified version of the action of the whole 
system — simplified in the sense of omitting a lot of detail that would 
just be confusing at this stage. The ROM of your Spectrum consists 
of a large number of short programs — subroutines — which are 
written in machine code. There will be at least one of these machine 
code subroutines for each keyword of BASIC, and some of the 
keywords may require the use of many subroutines. When you 
switch on the Spectrum at first, the piece of machine code program 
that is carried out is called the ‘initialisation’ section. This is a long 
piece of program, but because machine code is fast, carrying out 
instructions at the rate of several hundreds of thousands per second, 
you see very little of it — the only evidence on the screen is the black 
rectangular pattern that appears just before the Sinclair Research 
copyright notice. In this brief time, however, the size of the RAM 
has been checked (in case you added some extra chips last night). It 
has been cleared of any unwanted bytes, a process that is necessary 
because of the effects of switching a memory off and then on again. 
When a RAM memory is switched off, all the units of memory revert 
to the # setting, as you might expect. When you switch on again, 
however, there is no guarantee that they will all stay that way. In 
fact, roughly half of them go to the‘l’ setting, completely at random, 
so that if you were to read each byte of memory at the instant when 
the computer was switched on, you would find that each byte of 
memory stored a number between f) and 255, quite at random, with 
no rhyme or reason to the numbers. This kind of thing is called 
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garbage, and one of the tasks of the initialisation program is to 
replace each of these garbage bytes by a 9, by deliberately writinga — 
into each unit of the RAM memory inturn. Asa result, if you switch 
on and PEEK at RAM memory address above about 23909 you will 
find that the content of each byte is zero. 

Initialisation consists of a lot more than this, however. Of the 16K 
of RAM in the smaller Spectrum, a large chunk is used by the 
operating system, meaning that the machine code routines use the — 
RAM to store quantities that may have to be altered at various times — 
as the program is used, Addresses from 16384 up to 23755 are used in 
this way, and that’s more than 7K of memory (IK = 1024 bytes) o1 
of your 16K before you have typed a single character of BASIC. 
addition, once you start to enter a BASIC program, more RAM has 
to be set aside, this time at higher memory addresses for storing i 
quantities that are needed to make your program run. Every time — 
you ‘declare a variable’, for example, by using a line such as: F 


LET n= 29 or LET a$ = “Smith” 


you cause several bytes of memory to be taken up by entries which 
store the variable name, n or a$ or whatever you used, and t 


used for these purposes is called the Variable List Table (VLT),and _ 
it is kept immediately above the space used by your program. Add 
one line to your program, and the VLT has to be shifted up to make © 
more space. Delete a line, and the whole VLT list moves down to 
lower memory addresses. 

This is a type of behaviour that has to be controlled rather 
carefully because the computer must at all times keep a note of 
where this piece of memory is located. Thisisdone byanentryinone — 
of the pieces of RAM reserved for such an ‘index’. Since the 
principle is used very extensively, we might as well examine this | 
particular example in detail. 

The important addresses that the computer must keepatrack of 
are stored between 23552 and 23733, and the starting address for the 
variable list table is stored at the addresses 23627 and 23628. Now 
the addresses that we want to store will also consist of five-figure 
numbers like these, and we know already that one byte of memory 
can hold a number which is between #) and 255 inclusive. If you want 
to store numbers that are greater than 255, then you need at least one 
more byte, and the scheme that computers use to store address 
numbers is to take one more byte to store the number of complete 
256's in the number that is to be stored ~ using a scale of 256 rather 
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than a scale of two or ten, If we had two bytes stored which read, in 
order, 19,1; this would mean 19 + 256*1 = 266, If the bytes were, in 
order, 24,32, this would represent the number 24 + 256 *32 = 8216. 
Note that the order of storing the numbers is low byte, then high 
byte. To find the address number that is stored in the addresses 
23627 and 23628, then, we need to use the formula PEEK 23627 + 
256*PEEK 23628. The result of this is an address — and it’s the 
address of the starting point for the variable list table. 
Try typing into your Spectrum: 


19@ PRINT PEEK 23627 + 256* PEEK 23628 


and run this. Note the number that is printed. Now add some lines 
such as 19 LET n= 12 and 2 LET a$ = “Smith” and RUN again. 
You will get a larger number printed, because the start of the 
variable list table has been moved up to a higher memory address to 
make room for the additional lines of BASIC. Add still more lines of 
BASIC and the start of the VLT has to move even higher. Delete 


32767 (16K Spectrum) 


your BASIC iyi 65535 
program Medel 


t t HRG 


these ‘boundaries’ 
can move 


Fig. 2.1. The position of the variable list table (VLT) in the memory is not fixed 
itis placed just beyond the BASIC program, and will move up or downas the 
BASIC lines are added to or deleted. 


some lines, and the VLT can move lower again. When the memory 
addresses that are allocated for some purpose or other are stored in 
this way, we say that they are ‘dynamically allocated’. That’s also 
why the manual warns you not to alter the address of the VLT (bya 
POKE command), because this would cause the computer to lose 
track of some of its variables. Try it - use the command: 


POKE 23627,203:POKE 23628,92 


Now try to RUN and watch the chaos. Switch off and on again if 
your Spectrum hangs up and refuses to respond to keys. What you 
have done is to mislead the fast but brainless microprocessor that 
runs your Spectrum. 

This, incidentally, is an introduction to the POKE command, The 
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‘ i Eis the address whose byte 
pi Ste aman pipe you want to put i ts 
aoe we'll look at the POKE process in more detail, b; 
: hich is POKEd into memory 
moment, note that the number w 
example above is 23755 — where a BASIC program starts 
where the VLT should start. ; z 
Now try something very much more constructive when y 
regained control. We shall now take alook at what t 
Table contains. As you might expect, it has to conta 
the variable and its value, but the Spectrum does So} 
values so that it can find and use the values when it ne 
To start with, the first byte in the variable list tab! 
number greater than 49 denary. The reason for this 
computer can detect the Jasi line of a program 
numbers are restricted to the range of —) to 9999 denar 
9999 would be coded by the two bytes 15 (low byte 
byte), the high byte of the number can never exce 
high byte of the line number is always the first byte 
computer can check this byte, and if it is 4 or more, this 
the end of the BASIC program. ; 
This, however, means that some care is needed to ens: 
first byte of an entry inthe VLT is a number greater than 40, 
easy enough, because the ASCII code for a valid variable nai 
be a number greater than 49. The other point is to co 
variable names so that the computer can distinguish the | 
types of variables from each other. This is done by using on 
bits of the first byte for the variable name letter code, a 
top three bits for a coding for the variable type (num' 
array, etc.). This needs some more detailed explanation. 
; Fora simple number variable which consists of one letter 0 
first byte of its VLT entry is just the ASCII code for the n: 


want to know, but if we stick to integers, meaning positive who 
numbers less than 65535 as faras Spectrum is concerned, then for an 
integer less than 256, the number is stored as a single byte, the third — 
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byte following the coded name. If the integer lies between 256 and 
65535, then two bytes are used — the third byte holds the less 
significant part of the number and the fourth byte holds the more 
significant part (the number of 256’s). The fact that integers still need 
five bytes for storage is one of the factors which makes Spectrum 
BASIC so much slower than the BASIC of machines which can treat 
integers differently. 


19 LET a = 10 


29 LET b = 11 

30 LET c = 12 

49 FOR n = # TO 39 

50 PRINT PEEK (( PEEK 23627 + 256* PEEK 23628) 
Bay ", 

60 NEXT n 


Fig. 2.2. A program to investigate the storage of integers. 


Fig. 2.2 shows a simple program which allows you to investigate 
the storage of some integers, and displays the results on the screen. If 
the name of the number variable consists of more than one letter, 
another type of coding is needed, because otherwise the computer 
would still read the five bytes following the first character as if they 
were the value. The scheme that is used in this case is to add 64 to the 
ASCII value of the first letter of the name, then store each 
subsequent character in normal ASCII code form until the last 
character, which has 128 added to the ASCII code. This is done so 
that the computer can recognise the end of the name and then count 
out the next five bytes as the bytes used to hold the value. Fig. 2.3 
shows an example of this method that you can try for yourself. 

A quick look at a variable which is not an integer is instructive, 
and Fig, 2.4 shows such an example. What is of interest now is not 
the coding of the letter variable name, but the fact that all five bytes 
are used for coding the value. This indicates (see Appendix B for 


19 LET julie = 23 

26 FOR n = @ TO 17 

3 PRINT PEEK (( PEEK 23627 + 256* PEEK 23628) 
+ n) pall A 

49 NEXT n 


Fig. 2.3. How along number variable name is stored. 
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if LET a = -12 

20 LET b = -176 

30 LET c = -255 

49 FOR n = @ TO 17 

5 PRINT PEEK ((PEEK 23627 + 256*PEEK 23628) 
Beant ”, 

6 NEXT n 


Fig. 2.6. How negative integers are represented in the VLT. 


19 LET a$ = "Sinclair" 

20 FOR n = @ TO 17 

39 PRINT PEEK ((PEEK 23627 + 256*PEEK 23628) 
+n);" " 

40 NEXT n 


Fig. 2.7. Storing a string variable 


Fig. 2.6 shows what happens when the VLT stores a negative 
integer — once again you don’t need to be able to follow the coding 
exactly, but note that three bytes are used. Turning from number 
variables, Fig. 2.7 shows how a string variable is stored. The variable 
name is coded as the ASCII value minus 32, and the string sign, $ , is 
not included in the coding. Spectrum permits only single letter 
names for string variables, so the complications of extra letters do 
not arise in this case. The string name is followed by two bytes which 
store the number of characters in the string so that the computer can 
be instructed how many bytes to read. Since two bytes are used to 
store the string length (most computers use only one, which speeds 
up string handling), Spectrum permits very long strings at the 
expense of a byte which is wasted if strings of normal length are 
being handled. The length bytes are followed by the characters of the 
string using normal ASCII codes. 

Appendix C shows the coding that is used for arrays or numbers 
or characters (string arrays). This is rather more complicated, and 
the subject is touched on againin more detail in Chapter 9. While we 
are on the subject of storing variables, however, we can explain the 


19 FOR n = 9 To 17 
29 PRINT PEEK ((PEEK 23627 + 256*PEEK 23628) 
", 


Fig. 2.8. How the values for a loop are stored. 
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As you know, the computer shows the line you are typing on the 
bottom lines of the screen, before you use ENTER. You can delete 
parts of this line or lines, because the whole section is not put into the 
normal final resting place in memory, which starts at 23755. Instead, 
it is stored in a temporary space, a piece of memory that is called a 
‘buffer’. This is another piece of dynamically allocated memory 
which has to shift up each time another line is added to the BASIC 
program. That, incidentally, is why it can take a noticeable time 
between pressing ENTER and seeing the ‘K’ cursor appear again on 
the bottom line. 

Suppose, for example, you typed: 


If LET n= 12 


Until you press ENTER, this is treated as a temporary entry only, 
and is placed in the buffer space. If you had omitted the line number, 
then the line would never occupy any other space, but with the line 
number present, the computer is programmed to place this line into 
the main program memory space when ENTER is pressed. Where is 
the start of this program space stored? It doesn’t usually change, but 
nevertheless its starting address is stored at 23635, 23636, so that we 
can find the address of the first byte of the program by using: 


PRINT PEEK 23635 + 256* PEEK 23636 


and this number is usually 23755. If you alter this address by 
POKEing different numbers into 23635 and 23636, then your 
computer will not recognise that there is a program stored, because 
it can’t be listed or run unless the correct starting number is present. 
Furthermore, if the new address you have put into these two bytes is 
well above the first part, you could write a second program in this 
other piece of memory, list it and run it. By restoring the original 
address bytes into 23635 and 23636, you could then list, run and 
work with the first program, ignoring the second. You would have to 
be sure, however, ihat each program carried its own variable list 
table, and that the variable list table address was correct before 
running a program. 

Back to normal programming, though. What does this line of 
program look like when it is stored in the program space? We can 
find out by using a short piece of BASIC command, assuming that 
you have the line 19 still in the memory: 


FOR n = 23755 TO 23785: PRINT PEEK n;* ”;;:NEXT n 
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This is a direct command so thatit will not get mixed up with th 
that we want to investigate. 

Fig. 2.9 shows what you can expect to see — a string of nu 
which the key is the ASCII code for n, which is 119. We cai 


out in the listing, and knowing that 119 means ‘n’, we ca 


that 241 is the code for LET (there is a list of the codes for 


i} 10 12 vi) 241 119 61 49 
ojmameioonpee f 13 234 
Gaaguecszese fH OP | 233 

Cape sine ein oe 

Fig. 2.9. The appearance of a line of BASIC in memory - this BA\ 
allows you to look at how it is stored. 


in the manual), and we should know that 61 is the ASCI 
the equality sign. We can also see that the number 12i coded 
bytes of ASCII code, 49 for 1, 59 for 2. That codes LETn 
bytes, but there are 4 bytes ahead of LET anda largen ber of th 
after, with a 13 at the end of the string. The end byte is : 
that is used for the ENTER key, and the bytes between the 
13 are the coded form of entry which will be used in the va 
table: 14 is used as a signal that what follows is in correct 
code form, as distinct from ASCII form. The four bytes thi 
the LET code are of more interest to us at thc moment, ho 
because they illustrate yet another way in which the comp’ 
the RAM to keep a track of what is going on. The first tw 
the line number. Unlike all other two-byte numbers that 
computer uses, these are in conventional (to you) order, wi 
high byte (the number of 256’s) first, and the low byte second 
done, as was explained earlier, so as to allow the comput 
the end of a program by looking for a byte greater than 4. Yo 
19 should give rise to bytes @, 1, but if you had started wit 
1999, then the numbers would have been 232,3, because 3 * 
232 equals 1900. . 
What of the next two bytes? If you typed the line just as | 
shown it, then the next two bytes will be 12,0. This is in the m 
usual low then high order of bytes, and the number twelve is the tot 
number of bytes of codes in the line, includin g@thetext(LETn 
the VLT entry of the code for n and five bytes of value, and th 
byte at the end of the line, but excluding the four bytes at the sta 
Why is this length number needed? The reason is simple, like 
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action of the microprocessor. If the computer keeps a count of the 
bytes as it goes along, then the number that is stored in its address 
counter after it has read these two ‘length-of-line’ bytes will be the 
address of the first useful byte (LET in our example) in the program 
line. When this number has added to it the number stored in these 
two ‘length-of-line’ bytes, the result is the address of the start of the 
next set of the four bytes that give the line number and length for the 
next line. This is how the computer gets from one line to the next, 
how the correct number of bytes can be transferred to the ‘bottom- 
line’ of the screen (a different part of memory) for editing, and how 
lines can be re-sorted into order. 

Every time you type a new line of BASIC and ENTER it, then, 
you use up five bytes of memory for the line number, the length 
number, and the ENTER (code 13) byte. This is called the line 
overhead, and the interesting feature about it is the use of two bytes 
for the line length. Most computers use only one byte here, 
permitting lines of no more than 255 characters, and since most lines 
are much shorter than 255 characters, this byte is usually zero. There 
is a wasted byte in each line, therefore, unless you are in the habit of 
typing quite impossibly long lines. You can overcome some of the 
line overhead problems by making full use of multistatement lines, 
because the line number and length bytes are used only when a new 
line number is started, not when you use the colon to separate 
statements. Try this one: 


1f LET a = 12: LET g$ = “Sinclair” 
and then look at the line by using: 
FOR n = 23755 TO 23785: PRINT PEEK n;“ ”;:NEXT 


to look at the bytes that have been stored. The result is shown in Fig. 
2.10. Now try POKE 23756,20, and then LIST your program line. 


Vem a Ole 2416 97.61. 49, 5p, 
ee Omi ok? 8 8 58. 24) 
avgiesoy. ol 34 83 195 116 99 
Wa Sf. 105 114 34 13 


Fig. 2.10. The result of storing a multi-statement line. 


You have changed the line number to 20 simply by changing the line 
number byte! Now try some more POKEing. Type and ENTER: 
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avoids having to check this when the program is RUN, as other 
computers have to do. What happens then depends on what the 
instruction happens to be. If it is a simple assignation, like LET 
n = 12, then an entry is copied into the variable list table from the 
part of the line that starts with the code number 14. 

Acomplex assignation, like LET y = 2*n needs some more action. 
The code token for LET calls up a machine-code subroutine so that 
the name y is entered into the variable list table, but this routine has 
to be interrupted to carry out the multiplication routine, 2*n. This 
uses another set of machine code subroutines which first search 
through the variable list table to find the name n, extract its coded 
value, carry out the multiplication, and then return to the task of 
assignation, putting the answer that has been worked out into five 
bytes of the variable list table that follows the variable name entry. 

These two simple examples illustrate two important actions that 
take place during a RUN (RUN-time actions), making entries into 
the variable list table, and reading entries that have already been 
made. Most of the simple BASIC actions are of these types. For 
example, the command PRINT a§ will start with the token for 
PRINT, which calls up a PRINT subroutine (one of the longest and 
most complex in the ROM). This subroutine will in turn call up 
another one which will search for the entry for a$ in the variable list 
table and which will, once a$ is found, store the number of 
characters in a$ and the address of the first character. Now that the 
machine has some clue as to where to find the ASCII codes 
corresponding to a$, and how many of them are to be printed, it can 
complete the PRINT routine. This is quite complicated because of 
the design of modern computers like Spectrum. At one time, the 
PRINT routine only had to copy the bytes of the characters from 
their places in the program or VLT memory into another set of 
memory addresses called the video memory. This was a physically 
separate chunk of memory, so that a computer like the 16K TRS-80 
actually had 16K available for the user - the 1K that served the 
screen display was separate and not counted in this total. The 
convention that is used nowadays is to use a lot of the RAM for what 
the Spectrum manual calls a ‘display file’ - another form of video 
memory. This is part of the 16K or RAM which is used to store the 
bytes that dictate the shapes of characters and, on the Spectrum, 
each character needs eight bytes of RAM. These bytes, however, are 
not stored consecutively in the memory. Of the eight bytes per 
character, each is stored 256 places beyond the previous one. You 
can check this for yourself by using the simple BASIC program of 
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Fig, 2.11, which POKEs bytes into the memory locations that are 
used for the first character location on the screen. 

The bytes which are used to make up the characters that are 
printed on the keyboard are stored in the ROM and, as you might 
expect by now, the starting address of this set of bytes, the character 
set, is kept in the reserved RAM. The address stored in 23606, 23607 
is 256 less than the address of the start of this character set (so that 
the program which uses it can run in a loop which starts by adding 
256 to the address), which is at 15616. The character set is in the 


19 FOR n = § TO7 
20 POKE 16384 + 256 * n, 68 
39 NEXT n 


Fig. 2.11. POKEing to a screen location. This requires values to be POKEd to 
memory positions 256 bytes apart. 


ROM, but since its starting address is stored in the RAM, we could 
change this address to point to a new set of characters which we can 
store in RAM - this is what we do when we create the user-defined 
characters, in fact. The PRINT routine makes use of these stored 
character bytes, and sends copies to the correct addresses in the 
display file at the start of RAM, so that the TV circuits can then 
generate the signals which form the shape of the character of your 
receiver. At the same time, the ‘housekeeping’ routines swing into 
action to ensure that the next character will be either in the next 
space along, or placed wherever it is commanded by TAB or AT, or 
put into the start of the next new line. 

It would be possible to fill volumes by examining each action of 
the Spectrum in detail, but there isn’t much point as far as we are 
concerned here, because they all follow pretty much the same 
general pattern, Acommand word is represented in the memory bya 
token which at the RUN time is used to call up a subroutine, which 
will in turn make use of the variable list table and other subroutines 
to carry out its work. Sometimes a subroutine may have to ‘hang up” 
~ for example, a routine that carries out a PRINT n*k can’t get on 
with printing until the result of n*k has been calculated. The 
computer will have to provide for this, and its provision takes the 
form of using RAM for temporary storage, so that a number of 
bytes are reserved for this purpose. 

Finally, how does the computer call up the correct subroutine? It’s 
rather simple ~ when you know. The tokens, like the reserved words, 
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In this chapter, we'll get to grips with the Z-80A microproce 
the Spectrum. The microprocessor, or MPU is, you remem e 
‘doing’ part of the computer as distinct from the stori 
(memory) or the input/output part (the PORT), so that wha' 
microprocessor does will decide what the computer as a h le 

The MPU is itself a set of memory stores, but with ; 
organisation added. By means of circuits aptly named gates 
in which bytes are transferred between pieces of memory 
MPU can be changed and controlled, and it is these actions i 
constitute the addition, subtraction, logic and other actions of the 
MPU. Each action is programmed. Nothing will happen unless an — 
instruction byte is present in the form of a | ora @ signal at each } 


program instructions are in the form of electrical signals on e 
lines, these signals can be changed very rapidly. The speed is deci 
by another electrical circuit called a ‘clock-pulse generator’ ( 
‘clock’ for short). The Z-80A can work witha 4 MHz clock, meani 
that the clock can be operated at a rate of 4 million pulses per 
second. The microprocessor will then carry out its internal — 
operations at this rate, but since each complete action may require 
several internal operations, the rate of carrying out complete 
machine code instructions is rather less than this — typically a rate of 
half a million instructions per second. The clock speed that is used 
by Spectrum is 3.5 MHz-3¥, million clock pulses per second. 


Hardware and software 


The electrical parts of the computer are what we call hardware. 
Changing the design would be hard work, snipping contacts here, 
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soldering new ones there, making it into a mass of spaghetti that the 
designer would hardly recognise. The program which makes the 
assembly of hardware work like a computer is a form of software. 
It’s a lot more easily altered, because in the case of the Spectrum it is 
all contained in one ROM chip; change this chip and you have a 
rather different computer! A few computers in the ‘home’ category 
have very small amounts of ROM; practically all of their software is 
read in from tape or disc and can be changed very easily. This way, if 
you tire of BASIC you can load in another language and use that 
instead. Most of us, however, are likely to stay with BASIC in 
ROM, where it is safe from the effects of illjudged POKE 
commands! 

As far as the MPU is concerned, software is a collection of bytes, 
the collection that we call machine code. A program written in 
machine code is just to our eyes a list of numbers, each one havinga 
value between @ and 255. Some of these numbers may be instruction 
bytes, which cause the MPU to do something. Others may be the data 
bytes, which are numbers to add or store, or which may be ASCII 
codes. The MPU can’t tell which is which, and it is entirely up to the 
programmer to make sure that everything is done correctly by 
putting the numbers in the correct order. 

The correct order, as far as the MPU is concerned, is quite simple. 
The first byte that is fed to the MPU after switching on or after 
completing an instruction is treated as an instruction byte. Now 
some instructions consist of one byte only, and others need to have 
two or more bytes of further instruction or data following them. If 
you think of RND and TAB in BASIC, you'll remember that we can 
use RND by itself (though it can be multiplied by a number), but 
TAB must be preceded by PRINT and followed by a number in 
brackets. When the MPU receives an instruction byte, the only way 
that it can be instructed about what comes next is by the coding of 
that instruction byte. Instruction bytes therefore come in four types: 
(a) the ones that are complete in themselves, (b) the ones that need 
one extra byte of data, (c) the ones that need two extra bytes of data, 
and (d) some that need an extra instruction byte which may in turn 
be followed by data. Each instruction byte carries coding that the 
MPU can use to determine what comes next. 

The snag is that the programmer must get it right. 100% right is 
just about good cnough! Feed a microprocessor with an instruction 
byte when it expects a data byte, or with a data byte when it expects 
an instruction byte, and you have trouble in a big way. Trouble can 
mean an endless loop, which causes the screen to stop displaying any 


: 
a 
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memory to read the binary number that had been set up on the 
switches. In addition, some method of addressing the memory was 
needed, and this could be provided by the microprocessor itself, as 
we shall see later. 

Programming like this is just too tedious, however, and working 
with binary numbers is a process which can cause endless mistakes. 
Since every binary number is a set of 9's and I’s, after reading and 
entering a few dozen of them you start to make mistakes, 
exchanging @’s and I's, repeating numbers, and all the other 
possibilities. The obvious step is to make use of the computer itself 
to place the numbers in the memory, and an equally obvious step is 
to use a more convenient number scale. 

Just what is the most convenient number scale is a matter that 
depends on how you enter the numbers and how much machine code 
programming you do, A computer like Spectrum contains 
subroutines that convert binary numbers into a form that allows it to 
print denary numbers on the screen automatically, and also carry 
out the reverse transformation. When you use PEEK, therefore, the 
address that you use is in denary, and the result of the PEEK will bea 
denary number between and 255, When you use POKE, you can 
write both the address number and the byte number in denary. It 
makes sense, therefore, to work with the number system that we are 
used to and which the Spectrum uses for its own PRINT and input 
commands. 

Serious machine code programmers, however, find this just too 
inflexible a system. By far the best way of entering machine code 
programs is to write them in whatis called assembly language, which 
uses commands that are shortened words. Programs called 
assemblers can be written which will convert these commands into 
the correct binary codes. So that the programmer need never be 
bothered with the actual binary codes, many assemblers will show 
the codes on the screen in a form called hexadecimal, or hex. These 
assemblers will also require numbers to be typed in using hex code. 


Hex codes 


Hexadecimal means scale of sixteen, and the reason that it is used so 
extensively is that it is naturally suited to representing binary bytes. 
Four bits of binary digits, half a byte, will represent numbers which 
lie between @ and 15 on our familiar scale, which is the range of just 
‘one hex digit (Fig. 3.1). This means that a byte can be represented by 
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but you will certainly find that a knowledge of hex will be necessary 
if you use a different machine. You will certainly find that the more 
advanced books on machine code programming, some of which are 
listed in Appendix A, assume that you are fluent in the use of hex. 


The hex scale 


The hexadecimal scale consists of sixteen digits, starting con- 
ventionally with @ and ascending equally conventionally up as far as 
9. The next figure up is not 19, however, because this would mean 
sixteen (one sixteen and no units), and since we aren’t provided with 
symbols for digits beyond nine, we have to make use of the letters A 
to F. The number that we write as 1 in denary (one ten, no units) is 
written as @A in hex, eleven as (B, twelve as @C, and so on up to 
fifteen, which is 0F. The zero doesn’t have to be written, but 
programmers get into the habit of writing a data byte with two digits 
and an address with four, even if fewer digits are needed. The next 
number after OF is 10, sixteen, and the scale then repeats to IF, 
thirty-one, which is followed by 20. The maximum size of byte, 255, 
is in hex terms FF. When we write hex, it is customary to write an ‘H’ 
after the code, so that there is no possibility of confusing the hex 
numbers with denary numbers. A number such as 16 could be 
sixteen (denary) or twenty-two (one sixteen and six units), but there 
is no doubt about 16H. 

Now the great value of hex is how closely it corresponds to binary 
code. If you look at the hex-binary table of Fig. 3.2, youcan see that 
9 is 1991 in binary and F is 1111. The hex number 9FH is just 
19911111 in binary — you simply write down the binary digits that 
correspond to the hex digits. The conversion in the opposite 
direction is just as easy — group the binary digits into fours, starting 
at the least significant bit (right hand side), and then convert each 
group into its corresponding hex digit. Fig. 3.3 shows examples of 
conversion in each direction, so that you can see how easy it is. 

There are a lot of differences between computers in the way that 
they handle hex numbers. Some, like Spectrum make no provision 
at all for the use of hex, assuming that anyone who wants to carry 
out machine code programming in hex will use an assembler that 
deals in hex. Others, like the BBC Microcomputer, have a built-in 
hex translater; the BBC machine even has a built-in assembler. 

Assuming for the moment that you do not use an assembler to 
create your machine code programs, what do you do? The answer is 
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(a) Single bytes - numbers less than 256 
denary. 

Example: convert 153 to hex. 
153/16 = 9.5625 so 9 is upper digit, lower 
digit is §.5625 * 16 = 9, so that number is 
99H. 

Example: convert 58 to hex. 
58/16 = 3.625, so 3 is upper digit, lower 
digit is 9.625 * 16 = 16, A in hex. So that 
number is 3AH. 


(b) Double bytes - number between 256 and 65535. 
Example: convert 23815 to hex. 

23815/16 = 1488.4375. 9.4375 * 16 = 7, lowest 

digit. 

1488/16 = 93, @ remainder - § is next digit. 

93/16 = 5.8125. 9.8125 * 16 = 13, hex D. Last 

digit is 5, so that the complete number is 5DQ7H. 


Fig. 3.5. Denary to hex conversion, single or double bytes 


there is a fairly simple relationship between the ASCII codes for 
digits @ to 9, and the numbers themselves. If you add 48 to the 
number, then you have the ASCII code for that digit, which can be 
printed as a string character. A slight complication arises when we 
get to ten, because in hex this is A, and the ASCII code for A is 65, 
which is 55 greater than 1. The conversion program must therefore 
add 48 to a digit of 9 or less and 55 toa digit of ten to fifteen to make 
the correct conversion to hex code. This isn’t difficult for a BASIC 
program, and an example of denary to hex conversion program is 
shown in Fig. 3.6. 

Hex to denary can be done in much the same way, converting the 
ASCII code for each digit into the number digit itself, multiplying 
for the correct place factor (16,256,496), and then adding. The 
conversion can use a loop for both the multiplication and the 
addition, to obtain the denary number. Once again, the BASIC 
program is fairly simple (see Fig. 3.7) which is why the ‘£5 per 
published letter’ pages of magazines are always choked with denary- 
hex conversion programs for each new computer. 

Throughout this book, we shall use mainly denary codes, with a 
few hex values thrown in where they are needed. It’s only fair to 
point out, though, that there are parts of machine code programming 
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19 CLS: LET y = 1: LET d= @ : PRINT "Please 
type hex number" : INPUT hf 

20 IF LEN h$>4 THEN PRINT "Too long - maximum 
of four "'" characters please": PAUSE 169 : 


GOTO 19 
30 LET p$ = h$ (LEN hf): LET hf = hf (1 TO 
(LEN h$ - 1)) 


50 GO SUB 200 : IF LEN hf>@ THEN GoTo 34 

6@ PRINT "Denary number is "; d 

19% GOTO 9999 

200 LET a = CODE p$ 

210 IF a<48 OR a>102 THEN GO SUB 399 

229 IF a<65 AND a>57 THEN GO SUB 300 

225 IF a<= 97 AND a > 79 THEN GO SUB 399 

230 IF a<= 57 THEN LET q = a - 48 

240 IF a>= 65 THEN LET q = a - 55 

250 IF a>= 97 THEN LET q = a - 87 

260 LET d= d+q* y: LET y = y * 16 

270 RETURN 

300 PRINT "Bad hex ... please try again 
PAUSE 10%: RETURN 


il] 


Ww, 


Fig. 3.7. A BASIC program for hex to denary conversion. 


the same as those of its positive counterpart: +5 in binary is 
90000101 but —5 is 11111911, which doesn’t look like the same 
number. A second disadvantage is that using one bit as a sign bit 
leaves fewer bits for representing the number value. If we use the 
highest bit of a single byte number asa sign bit, then the remaining 7 
bits can represent numbers only as high as +127. We can, of course, 
also represent a negative number down to —128, so that we haven’t 
lost anything from the range of numbers that we can represent. If we 
use two bytes, then losing one bit to use as a sign bit means that the 
range available is —32768 to +32767 in denary. Using five bytes for 
each number, as Spectrum does, means that a single bit used for sign 
purposes does not greatly affect the range of numbers that we can 
use. 

The third disadvantage is that human readers cannot distinguish 
between a single byte number which is negative, and one which is 
written with no regard for sign. The short answer is that the human 
operator doesn’t need to worry ~ the microprocessor will use the 
number in the same way no matter how we happen to think of itand, 
in this book, you will soon see how the conversion is made and used 
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Registers - PC and accumulator 


A microprocessor consists of sets of memories, of a rather d 
type compared with ROM or RAM, which are called reg: 
These registers are connected to each other and to the pins o 
body of the MPU by the circuits called gates. In this chapt 
shall look at some of the most important registers in the 
(identical to the Z-80A and Z-80B) and how they are used. A goo 
starting point is the register called the PC (or Program Count 
The PCis a sixteen-bit register which can store a full-sized ad 
number, up to FFFFH or 65535 denary. Its purpose is to co 
instruction bytes (not programs!), so that the number tha 
contained in the register will be incremented (increased by 
automatically each time an instruction byte is read. This is 
completely automatic action which doesn’t need any instruction 
from the programmer, because it’s built into the action of the Z-80. 
The PC register will start at a count of zero when the Z-80 is fir: 
switched on, so this is where the first instruction of the ROM 
start. 
; The usefulness of the PC is that itis the method by which memory 
is addressed. When the PC contains an address, the electrical signal: 
corresponding to the ’s and 1’s of that address appear ona set 0 
connections, collectively called the address bus, which link the 
microprocessor to all of the memory, RAM and ROM. The number 
which is stored in the PC register therefore selects one byte in the 
memory, the byte which has that address. At the start of an 
instruction, the microprocessor will send outas 
signal on another line, which will cause the me 
stored bits to another set of lines, the data bus. The signals on the 
data bus therefore correspond to the pattern of @’s and 1’s stored in 
the byte of memory that has been selected by the address in the PC. 


ignal called the read 
mory to connect its 
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Each time the number in the PC changes, another byte of memory is 
selected, so this is the way that the microprocessor can keep itself fed 
with bytes, incrementing the number in the PC each time a byte has 
been read. 

There are other ways in which the PC number can be changed, but 
for the moment we'll pass over that and look at another register, the 
accumulator. The accumulator is the main ‘doing’ register of the 
MPU, meaning that you would normally fill it by copying a byte 
from memory (loading the accumulator), or use it to write to 
memory (loading memory from the accumulator), The memory byte 
which is used in each case will be the one whose address is stored in 
the PC at the time. 

As the name suggests, the accumulator also holds the result of 
operations. If you have a number byte stored in the accumulator, 
you can add another number to it, and the result will be stored back 
in the accumulator. It’s as if you had a number variable called Total, 
and you wrote the BASIC line: 


LET Total = Total + extra 


where extra is a number that you add to Total. The difference, and 
it’s an important difference, is that the accumulator can’t store a 
number greater than 255 because it is a single-byte register. 

The importance of the accumulator is that there are more 
instructions which affect or use this register than any of the many 
other registers in the Z-80. When a byte is read into the MPU, it is 
generally read into the accumulator. When arithmetic is done it is 
normally done in the accumulator. When a byte is stored in memory 
it is usually stored from the accumulator. Unlike earlier designs of 
microprocessors, the Z-80 has a large number of registers which can 
be used in much the same way as the accumulator, but none of them 
has the same range of possible operations. 


Addressing methods 


When we program in BASIC, we don’t have to worry about memory 
addresses — these are taken care of by the operating system in the 
ROM. When a variable is allocated a value ina BASIC programas, 
for example, by a line like: 


LET n= 12 


we never have to worry about where the number 12 is stored. 
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wouldn't fit) but rhe byte which is stored at this address. The effect of 
the complete instruction, then, is to place a copy of the byte stored at 
address 7FFFH into the accumulator. When the instruction has 
been completed, the address 7FFFH will still hold its own copy of 
the byte because reading a memory does not change the content of 
memory in any way. 

The way in which operands are written in assembly language 
follows the order destination, source, so that if we write: 


LD (7FFFH),A 


then this means that the byte stored in the accumulator is copied to 
the address 7FFFH. Note the use of the brackets again. Some types 
of microprocessors use the word ST (store) for this type of action, 
but the Z-80 uses only the order of writing the quantities and 
symbols. 


Indirect addressing 


Immediate addressing and direct addressing (also called extended 
addressing) are useful, but the Z-80 also permits a very handy form 
of what is called indirect addressing. Indirect addressing means 
going to an address, an address pair in fact, to find another address, 
and then using this second address to find or send the data byte. It’s 
rather like going to a travel agency to find the address of a hotel in 
which you can take a room (or eat a bite?). The form of indirect 
addressing which the Z-80 uses is called register-indirect, and it 
makes use of some of the other registers in pairs. 

The use of eight-bit registers in pairs to hold a full sixteen-bit 
address is a special feature of the Z-80, and one which helps to make 
it such a popular microprocessor with designers of computers that 
are intended for business and other serious uses. There are three sets 
of such registers which are labelled as HL, BC and DE respectively 
and, of these, the HL pair are the ones used most frequently for this 
purpose. All of these registers can be used singly, incidentally, just as 
if they were spare accumulators, but with a more limited range of 
actions. 

We can load a complete address into the HL pair of registers by 
using a command which is written in assembly language in the form: 


LD HL,32767 or LD HL,7FFFH 
This means that the high byte of the address, 7FH in the hex version, 
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carried out, Early types of microprocessors used PC-relative 
addressing for practically all of their actions, but the Z-80 uses it 
only for one small set of instructions — the jump-relative (JR) 
instructions. 

A jump-relative means a transfer to a new address using a PC- 
relative addressing method. The complete JR instruction consists of 
two bytes, the operator JR and the operand, which consists of a 
condition and the displacement. The instruction needs some care 
and experience, though, because the displacement byte is treated as 
a signed byte, meaning that if the most significant bit of the byte is I 
(denary value 128 or more) then the byte is treated as a negative 
number, and the address which is obtained when this byte is added 
will be (ower than the address which existed in the PC before the JR 
instruction. In terms of denary numbers, then, if the byte is 127 or 
less, there will be a jump forward; if the byte is 128 to 255, there will 
be a jump backward. When the jump of address has occurred, the 
PC will then resume normal action from that address and will not 
return to its previous address unless by the action of incrementing (if 
the jump was back) or by another jump (if the jump was forward). 

When we use PC-relative addressing, we will have to work out the 
value of the displacement byte. When an assembler program is used 
to convert the assembly language into code, the displacement byte 
will be calculated by the assembler program, but when you assemble 
‘by hand’, then you will have to calculate it for yourself. The 
calculation is like this: 


(1) Write down the address at which the operator byte of the JR 
instruction will be placed. This is the source address. 

(2) Write down the address to which the program must jump, 
which is the destination address. 

(3) Subtract source address from destination address, and then 
subtract two from this answer. What you now have is the 
displacement in denary terms. Ifit is positive, use it directly. If 
it is a negative number, subtract the value from 256, and use 
the result as the displacement. 


Why subtract 2? It’s because the displacements always calculated 
from the operator address, but the jump can’t take place until the 
operand containing the displacement has been read (which means 
that the PC will have incremented), and in addition, the PC will 
increment automatically at the end of the instruction. By subtracting 
2, we allow for these two incrementing actions, and obtain the 
correct displacement byte. Fig. 4.2 shows some examples of positive 
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registers which we seldom, if ever, use ~ the interrupt (1) and the 
refresh (R) registers whose uses are rather specialised, Another 
single byte register, however, the status or flag register, is of very 
great importance despite the fact that we cannot store or load it 
directly. The status or flag register is a way of keeping a score of 
results. When an arithmetic operation like addition or subtraction, 
ora logic operation like AND, OR or XOR, is carried out, the result 
in the accumulator may be a number that is positive, negative or 
zero. This ‘status’ of positive, negative or zero is indicated by the 
state (@ or 1) of bits in the status register, The status register is not 
particularly well named, because it’s not really a register which can 
store a number, but just a collection of single bit stores with no 
connection between them. Some books call this the flag register 
because this is such a descriptive name — a flag is raised each time one 
of these results is available, and stays raised until a new result 
appears. 


¥ 6 5 4 3 2 7 @ bit position 


Carry flag—setifthereis acarry orborrowinarithmetic C—carry flag 


N-Flag—set for subtract operation N—add/subtract flag 
2-Flag—set by zero result of some operations PIV—parity/overflow flag 
S-Sign flag—set if result is negative H—half-carry flag 

Z—zero flag 

S—sign flag 

Z—not used 


(Other flags have rather specialised uses) 


Fig. 4.3. The Z-80 status register. Bits 3 and 5 are not used (they may be at 
either @ or 1 permanently). 


Fig. 4.3 shows the layout of the Z-80 status register. The bits that 
we will be most interested in are the S,Z and C flags, bits 7,6 and @ 
respectively. The S-flag is 1 when the byte in the accumulator is 
negative after an arithmetic/logic operation; the flag value will be @ 
if the accumulator byte is positive or zero. The Z-flag is | if the 
accumulator contains zero after any of the operations that affect the 
flags but it will be @ otherwise. The C flag is | if there has beena carry 
resulting from an addition, or if a borrow is needed ina subtraction. 
Any register which can be used for the operations that affect the 
flags will also be signalled by the flags, so that if you are working 
with the C registers and a subtraction causes a zero to appear, this 


2-80 Details 55 


displacement byte rather than the PC + displacement address that 
we would find if the condition was met by having the accumulator 
(or other register) zero. 

One peculiarity of the way in which the Z-80 uses its status register 
is that only certain actions, particularly arithmetic and logic actions, 
actually affect flags. Load and store operations do not affect flags, 
so if you have previously used 6502 machine code, you will have to 
adjust your thinking! For example, suppose we have a piece of 
assembly language that reads: 


LD A,(HL) 
DEC A 

LD A,(DE) 
JR Z,Disp 


If the DEC A (decrement the accumulator) action, which is one that 
can affect flags, causes the contents of the accumulator to become 
zero, then the jump at the JR Z,Disp stage will be carried out, even 
though the accumulator has been reloaded from DE and probably 
does not contain a zero byte any longer. This is very much a Z-80 
peculiarity, and one that can at times be very useful. 


Index registers 


The Z-80 also contains two index registers. These are 16-bit 
registers, so that they can hold a full 16-bit address number, and they 
are labelled as IX and IY. The reason for the word ‘index’ is that 
these registers can be used in a form of addressing that is similar to 
the action of a book index. An address called the base address or 
page address is held in an index register, and any address up to 127 
numbers higher or 128 numbers lower than this base address can be 
used by adding a displacement byte to the index address. In 
assembly language, this is written as (IX + d) or (IY + d), where d 
means the single byte displacement. We can use commands such as 


LD A\IX + d) 


in this way, meaning that the accumulator will be loaded from the 
address which is equal to the base address stored in IX plus the 
displacement. The IX register would have to have been loaded 
earlier in the program. We shall not elaborate on this very brief 
description, because the IX and IY registers are used very 
extensively in the operating system of the Spectrum, and the manual 
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Accumulator actions 


Since the accumulator is the main single-byte register, we can list its 
actions, and describe them in detail, knowing that the description 
will also hold true for any of the other single-byte registers that can 
be used in the same way. Of all the single-byte register actions, 
simple transfers of bytes are by far the most important. We don’t, for 
example, carry out any form of arithmetic on ASCII code numbers, 
so that the main actions that these require of the microprocessor are 
fetching and storing - loading the accumulator from one memory 
address and storing the byte back at another address. The systems in 
which the Z-80 is used do not permit a byte to be copied directly 
from one memory address to another, so that the rather clumsy- 
looking method of loading from one address and storing to another 
is used almost exclusively. 

The next most important group of actions is the arithmetic and 
logic group, which contain addition, subtraction, AND, OR and 
XOR and NOT. Wecanadd two others to this group: SHIFT, which 
causes all the bits of a byte to move along one place (you have to 
specify in the command whether you want left shift or right shift, 
among other details), and ROTATE, which connects the ends of the 
register before carrying out a shift (see Fig. 5.1). 

The effect of the main shift and rotate commands, with their 
assembly language mnemonics, is shown in Fig. 5.2. A shift always 
results in the register losing one of its stored bits, the one at the end 
which is shifted out, and gaining a zero at the other end. A rotation, 
by contrast, keeps the bits stored in the register, but changes the 
position of the bits in the byte, though preserving the relative order. 
These instructions are used mainly for selecting half-a-byte (one hex 
digit) for arithmetic purposes, or for sending one bit at a time out 
from, or reading one bit at a time into the register as is needed in 
Cassette recording or replaying operations. Fig. 5.3 summarises the 
arithmetic and logic group of commands, and their assembly 
language mnemonics. 
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ADC HL, rr Add with carry bit the byte in 
a register pair to the bytes 
in HL. Result stored in HL. 
Carry flag set if there is a 
carry out. 

SBC HL, rr Subtract the contents of the 
register, and the carry bit, 
from the contents of HL. Store 
result in HL, set carry if a 
borrow takes place, 


NOTE r has been used to indicate a register, 
such as B, C, D, E, etc., or an immediate—- 
loaded byte, or the contents of an address or 
an address held in a register pair, such as 
(HL). Not all addressing methods will be 
available for each command. 


Fig. 5.3 Continued 


Note the way that comments are put into the assembly language 
statements, treating the semicolon like a REM in BASIC — anything 
following the semicolon is a comment and not part of the 
instruction. 

When a single register is incremented or decremented, the result 
will affect the flags in the status register, so that the S-flag will be set 
(to 1) if the result is negative, reset (to ()) if the result is positive or 
zero, and the Z-flag will be set (to 1) if the result is zero. When the 
byte whose address is held by a register pair is incremented or 
decremented using INC (HL) or DEC (HL), the same applies; flags 
will be set or reset according to the result of the action. When a 
double register pair is incremented or decremented, however, by 
such instructions as INC HL or DEC HL, then the status register is 
not affected. This is a quirk of the instruction set of the Z-80 which is 
often rather a nuisance, but there isn’t much we can do about it. 
Ways of programming so as to set flags will be dealt with later. 

CP, the mnemonic for compare, is a particularly useful form of 
arithmetic instruction. CP has to be followed by a byte, a register, or 
some source of a byte such as (HL) or (address), and it compares the 
byte that is fetched with the byte that already exists in the 
accumulator. Comparing is rather like subtraction, but there is one 
vital difference. If, for example, we had the byte 5@ in the 
accumulator, then SUB 49 would have the effect of leaving 19 in the 
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re space for your own machine code bytes just unde; 
this scent td CLEAR. CLEAR 3259, for example, will cause 
the RAM between 32509 and 3269 to be reserved for your machine 
code programs, and if you do not use the defined graphics in your 
program, there is nothing to prevent you from using the space 
between 3260 and 32767 as well. 

The next problem is how to place the address of the start of your 
machine code program into the PC of the Z-80A. Once again, there 
is a BASIC instruction which copes with this, USR. When USR is 
followed by an address, the computer places that address into the 
PC of the Z-80A (and into the BC register pair as well), so that your 
program will run, By way of a bonus, when the Spectrum returns to 
normal operation, it will make a number available to you. This 
number will be the number stored in the BC registers, and you will 
see it printed on the screen if you started your program by: 


PRINT USR address 

or you can assign it to a variable by using: 
LET x= USR address 

or ensure that nothing is printed or assigned by using: 
RANDOMIZE USR address 


Note that USR cannot be used by itself —it has to be used after a ‘do- 
something’ statement. You may not wish or need to have a number 
returned to BASIC, but it’s very useful. If your program does not 
make any use of the BC registers, then what you get back is the 
address number that followed USR when the program was called. 
The next thing is to ensure that the machine code program will 
stop in an orderly way. Nothing you have done so far will indicate to 
the Spectrum where the end of the machine code occurs, so that it 
will continue to read bytes after the end of your program until it 
encounters some byte that will cause a ‘crash’. You can prevent this 
by making the last byte of each program a ‘return-from-subroutine’ 
byte, code 21 denary, C9H, which will automatically cause a return 
to BASIC when the program has been started by a USR address 
command. 
bce bi bel a point that we don't have to worry aboutat 
preity : fen you use a machine code program, you are 
ant g tus program on the same Z-80A microprocessor as is used 
or all the actions of the Spectrum. If we make use of the Z-80A 
Tegisters, we must be quite certain that we are not destroying 
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information that is needed for Spectrum. For example, if, at the 

instant that your machine code program started, the Z-80A 

contained in its BC registers the address of the start of the table of 
reserved words (looking for USR, perhaps), then it wouldn’t be a 

good idea to replace this with something else. When a machine code 

program is called into action by using the USR instruction, 

however, this problem is taken care of for you. The contents of most 
of the registers are placed in a part of reserved RAM which is often 
called ‘the stack’. This, incidentally, is another reason for being 
careful as to how you place your machine code in the memory - if 
you wipe out any of the stack the Spectrum will quite certainly not 
like it. When the RET instructions are carried out, the register values 
are restored equally automatically, and normal BASIC action can 
resume. If you call a machine code program into action by any other 
method, as is possible using some assembler programs, then you will 
have to do this salvage operation for yourself. The assembler 
language mnemonic for saving register contents is PUSH, and the 
registers are pushed in pairs, AF,BC,DE,HL, and so on in 16-bit 
sets. To get them back, POP instructions for the same registers are 
used, and the registers have to be restored in the correct order — last 
in, first out, like NEXTs after FORs. If you have used: 


PUSH AF 
PUSH BC 


at the start of your program, then you need: 


POP BC 
POP AF 


at the end. If you use: 


POP AF 
POP BC 


then you will have interchanged the contents of AF and BC! This is 
sometimes done deliberately (it’s one way of changing the status 
register contents, for example), but it’s not a technique for the 
beginner. 

For the moment, then we’ll forget about PUSH and POP because 
the problem simply doesn’t arise when we use USR as a way of 
starting the program, There is one exception, however. Spectrum 
makes a lot of use of the 1X and IY registers, and these do not appear 
to be saved when a USR instruction is carried out. It may be that they 
can be used safely if they are PUSHed before using and POPped 
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which is 85 denary. Therefore 85 is the byte that has to be stored in 
the next address, making the table look like: 


32500 62 
32501 85 


The next byte we need is the instruction code for LD(Addr),A, 
and this is 5@ denary, 32H. It goes down into the table, and then it 
has to be followed by the address that we want to use, which is 
32510. The snag here is that this address has to be converted into 
two-byte form, and the bytes written in the correct order, lower byte 
first. You'll find it simpler if you have a calculator handy, or 
Spectrum switched on! Using a calculator, find first 32519 + 256 - 
this gives 126.99218. Write down the 126, which is the higher byte 
number, and label it HB. Now carry out the calculator steps (the 
circles round the symbols indicate that each of them is on a 
calculator key): 


126 256 ©) © @ 3250 © 


What you are doing is multiplying 126 by 256 to get 32256, and then 
subtracting this from 32510 to get 254, which is the lower byte. You 
can now write the address 32519 in low, high order as 254,126 into 
your table, which now appears as: 


32500 62 
3251 85 
32562 50 
32503 254 
32504 126 


There’s one last entry at address 32595, the return byte 201. If you 
are unhappy about the way of finding the bytes corresponding to the 
address number, use the Spectrum program shown in Fig. 5.5. 

The next step is to place this short program into the memory. We 
have to start by clearing a space, using CLEAR 325, and then 
POKEing the bytes in one by one. Since Spectrum, unlike the ZX- 
81, can use READ ... DATA, the POKE operation is most simply 
done using a loop, and since we know how many bytes we have, we 
can use the loop to read the bytes and place them into the correct 
address, starting with 32599. The program reads: 
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you now press NEW and ENTER, you will see the screen clear after 
the black rectangle appears, but your machine code program is NOT 
cleared, though the BASIC program that put it into place will have 
gone. If you type PRINT PEEK 32516 you will see that the result is 
still 85, and if you clear this piece of memory by typing: 


POKE 32519,0 


followed by ENTER, of course, then you can check by another 
PEEK that this memory has been cleared. Your program still exists, 
however, and can be used again to load the number 85 into the 
address 32519. This time, try: 


LET x = USR 32500 (and ENTER). 


Nothing appears on the screen as a result of this form of command 
(though variable x is allocated to 32500, and PRINT x will reveal 
this), and you will find when you use PEEK 32519 that the value 
stored here is 85 once again. If you want to clear the memory 
completely, you can type 


CLEAR 32767 (for a 16K machine) 


and ENTER, then NEW (ENTER). This will remove everything, 
and if you forgetfully type PRINT USR 32599 and ENTER now, 
some number may be printed on the screen, but the computer will 
‘lock-up’, no key having any effect, or possibly go into its NEW 
routine. If you get a lock-up, which is very common when a machine 
code program goes wrong, then all you have to do is to switch off 
and on again. Your program will, of course, be lost when you do 
this, but see Chapter 7 for how to save machine code on tape. 
We very seldom need to clear the memory out in this drastic way. 
If you have reserved spaced for a machine code program by typing 
CLEAR 32509, then you can write as many programs as you like in 
this space. If you use the same addresses again, then the most recent 
program will replace any previous ones, but as long as each program 
uses a 291 code to return to BASIC, the old program bytes that are 
still stored at other locations will not affect the new program. One 
thing to watch, however, is how you use memory for storage, 
thinking back to the way in which we stored the byte 85 in address 
3251. If the address that you usc for storage in this way is inside the 
range of addresses that you use for your program, then you will have 
to write your BASIC program so that some bytes are POKEd before 
this address and some after but none in. Don’t assume that because 
you didn’t place anything there, there is nothing in the address! You 
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5; 85 into accumulator 


5 
RL A 5 rotate left 
LD B, @ 5 zero B 

LD ¢, A 3; load in result 
RET 5 return 


Fig. 5.7. An assembly language program which will return with a byte in the 
BC registers. 


and ENTER, however, the number 179 appears on the screen, and 
this demands some explanation. What the program has done is to 
load the number 85, which in binary is 91919191 into the 
accumulator. A left rotation of this, Fig. 5.8, gives the number 


oo to 1 oO 1 denary 85 
—left rotation— 


1o@tostegotd@d denary 170 


Fig. 5.8. Explaining the number which appears 


16191019 in binary, and this in denary is 17. By loading register B 
with zero, and carrying out LD C,A so that the single byte number 
179 is copied from A to C, you end up with 179 in the BC register 
when the program returns. As Spectrum will always return with the 
number in the BC register pair (unless RANDOMIZE 3259 is 
used), the PRINT part of the USR call will ensure that this number 
is printed. Had you used LET x = USR 3259, then the value 
allocated to x would have been 176. 

Now try this. List your BASIC program, and delete the numbers 
6,0 from the DATA list, being careful not to leave a space with two 
lots of commas, The DATA list will now read: 


199 DATA 62,85,203,23,79,201 


and you will have to alter line 2 to read FOR n= 0 TO Sin place of 
the old count of 7. Now RUN to place the codes into memory, and 
use PRINT USR 32500 again. This time you get the number 32426 
appearing, Why? 

The answer is simple. The Spectrum operating system places the 
address that follows USR into the BC register pair. The address 
325 has a high byte of 126 and a low byte of 244 (so that 32500 = 
126 X 256+ 244), so that when USR 325( is called up, the content 
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The simple programs that we looked at in Chapter 5 don’t do much, 
though they form very useful practice in converting assembly 
language into code bytes, putting them into the machine and 
running the resulting program. In this chapter, we shall look at how 
simple machine code programs are designed — in other words, how 
to get to the assembly language version, because this is by far the 
most difficult part of the process for the beginner to machine code 
programming. 

The difficulty, curiously enough, doesn’t arise because machine 
code is difficult but because it is simple. Because machine code is so 
very simple, you need to use a large number of instruction steps to 
achieve anything useful, and when a program contains a large 
number of steps, it’s more difficult to plan. The most difficult part of 
the planning is breaking down what you want tu do intoa set of steps 
that can be tackled by assembly language instructions, and for this 
part of the planning, flowcharts are by far the most useful method of 
finding your way around. I never feel that flowcharts are ideally 
suited for planning BASIC programs, but for machine code, they 
can be very useful indeed. 


Flowcharts 


Flowcharts are to programs as block diagrams are to hardware — 
they show what is being done (or attempted!) without going into any 
more detail than is needed. A flowchart consists of a set of shapes, 
each one meaning some type of action. Fig. 6.1 shows some of the 
most important flowchart shapes for our purposes (taken from the 
British Standard set), the terminator (start or stop), input/output, 


"process (action) and decision steps. Inside these shapes we write the 


action that we want, but without details. 
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block, which is labelled ‘get character’. This describes what we wa 
to do - how we do it is something we don’t know yet. After renin 
the character, the next ‘action’ block is: ‘put into BC’, because that é 
what we need if the value of the ASCII code is to be returned to tte 
BASIC routine. Following that, the ‘print character’ block is 
something we can do in BASIC (it’s not so straightforward in 
machine code), The END terminator then reminds us that the 
program ends here ~ it’s not an endless loop. 

This is a very simple flowchart, with no decision steps or loops 
but it is enough to illustrate what we mean. Note that the 
descriptions are fairly general ones, so don’t ever put assembly 
language lines into the action boxes of a flowchart, for example, 
because that is just downright confusing. Strictly speaking, I 
shouldn’t have used the ‘put into BC’ box, but this is so essential to 
getting a number back into BASIC that it really needs to be 
mentioned as a reminder. A flowchart should show anyone who 
looks at it what is going on; it shouldn’t be something that only the 
designer can understand and which serves mainly to confuse 
everyone else. A lot of flowcharts, alas, are constructed after the 
program has been written in the hope that they will serve to make the 
action of the program clear. You wouldn’t do that, would you? 

Once we have a flowchart, we can check that it will actually do 
what we want by going over it very carefully. In the example of Fig. 
6.2, the parts labelled ‘get character’ and ‘put into BC are going to be 
done using machine code, so we'll concentrate on them for now. 

Getting the ASCII code for a character looks tricky at first. A lot 
of computers put the ASCII code into the accumulator during the 
subroutines of reading the keyboard, and then store the value 
temporarily in RAM. Looking at the description of the Spectrum 
system variables in Chapter 25 of the manual reveals that address 
2356 is used for this purpose — the code for the last key pressed is 
stored here. If we load A from this address, we should then have in 
the accumulator the ASCII code for the last key that was pressed; 
step 1 completed. The next step is already familiar — we want @ in the 
B register, and to copy the byte in the A register into the C register. 
This is necessary because we can’t load the C register directly froma 
memory address — that’s one of the restrictions which makes the A 
Tegister more useful for a lot of purposes than any other single-byte 
register. Having loaded BC, we can then return to BASIC, and make 
‘use of the code in BC in our BASIC program. If we call the program 
by using LET x= USR 325), then we can print CHR$ x to display 
the character. 
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something more ambitious, and at the same time probe the secrets of 

the Spectrum rather more deeply. Earlier on, we found that there 

were certain difficulties attached to trying to simulate the action of 

INKEY$ without using BASIC. Well, now is the time to show the 

way. There is a machine code routine in the ROM for reading the 

keyboard, and if we can find it, then we may be able to make use of it 

in our programs. Finding the routine with the aid of the Campbell 
disassembler wasn’t difficult. I looked for a piece of program that 
joaded the address 23569, and having found this, traced it back to 
find where it started. This led me to the address $2BFH, 793 in 
denary, as the start of a routine which read the electrical signals from 
the keyboard and converted them into ASCII codes. A preliminary 
try-out showed me that the routine placed 255 in the accumulator if 
no key was pressed, and the ASCII code for the key if a key was 
pressed. 

Now the new feature for you at this stage is how youcan make use 
of a Spectrum ROM routine. A subroutine in BASIC is called by 
using GOSUB, and the return is forced by using the BASIC 
command RETURN at the end of the subroutine. In assembly 
language, a subroutine is called by CALL, followed by the address 
of the start of the routine. The return is forced by the RET 
instruction which we have already used. CALL and RET have to be 
used together, and the reason that we were able to use RET at the 
end of our routines to return to BASIC is that the CALL part of the 
process has been done by the USR routine. 

We can get a byte into the accumulator from the keyboard by 
using CALL 793 as an instruction. The CALL code is 205, and the 
address which is called must be written in the usual low-byte, high- 
byte form (you must follow CALL by two bytes of address, even if 

! one is zero). The address 793 is coded as 191,2 , so that the set of 
numbers 295,191,2 will carry out the action of CALL 703. 
hi Fig. 6.8 illustrates the flowchart we shall need for this program. 
the byte is fetched from the keyboard, using the CALL, and tested 
for equality to 255, because this is the number that the ROM routine 
will put into the accumulator if no key is pressed (it’s the number 
_ that means ‘false’). If the byte equals 255, then the call is repeated, 
z but ifa key has been pressed, then the value in the accumulator will 
__ be the ASCII code for that key. This value in the accumulator can 
__ then be passed to the BC registers as before. : 
Fig. 6.9 shows a BASIC program that POKEs the code into 
ory and uses it. Just for a change, I've illustrated a quicker way 
sing the POKE and USR commands. By having LET j= 32500 
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early in the program, we can save memory by using j in place of 
32509. Since this saves. a conversion from ASCII to binary each time 
32509 is used, it saves time. The program does in machine code what 
INKEYS does in BASIC; it waits for a key to be pressed, and then 
returns with the value of the ASCII code in the accumulator. 

This is the first use that we have made of a routine in the ROM 
and it’s not always something that we can do easily. It’s not 
necessarily easy to find ROM routines unless you have a 
disassembler, lots of time, and some confidence in reading assembly 
language code - it was fortunate that the INKEY$ routine was so 
easy to spot. There are, however, complete commented disassemblies 
of the ZX-81 ROM available, so it’s just a matter of time before we 
find some similar treatment for Spectrum (some of the routines are 
almost identical, though not always in identical addresses). When 
this is done, you will be able to look up the routines and use them for 
yourself, though you must be careful to make sure that your 
registers are loaded correctly before calling the routines. 

It’s time now to try something for yourself. Can you combine the 
routine we have just examined, the machine code equivalent of 
INKEYS, along with the idea of subracting 32 if the byte is 97 or 
more, to get a routine which will put all printing into upper-case? 


Loops 


The loop action in BASIC that you use most of all on the Spectrum 
is the FOR ... NEXT loop. This uses a ‘counter’ variable to keep a 
score of how many times you have used the loop, and compares the 
value of the counter with the limits you have set on each pass 
through the loop. Now the action of a FOR ... NEXT loop can be 
simulated without using FOR ... NEXT, as is shown in Fig. 6.10, 
using an IF... THEN line to make the decision as to whether or not 
to keep looping back. Most types of microprocessors can tackle 


19 LET count = 9: LET end = 19 

29 PRINT "Action "; count 

3 LET count = count + 1 

49 IF count < = end THEN GOTO 26 


59 PRINT "Finished" 


ig. 6.10. How the action of a FOR... NEXT loop can be simulatedin BASIC. 


‘Storing and reloading 


‘Up to this point, we have generated machine code programs as 
BASIC routines which POKEd the numbers into memory. This is 
easy to carry out, and there is no reason why the whole program 
should not be saved as a BASIC program. If you use the Campbell 
_ disassembler, you will find that you can use it to place code in 
memory, using hex rather than denary, and this can be faster than 
riting READ ... DATA loops in BASIC. You then have the 
problem of how to save such a program on tape, when there is no 
: BASIC program that has generated it. The same problem arises 
you have used the ASC ULTRAVIOLET assembler to 
luce machine code which must be recorded and relocated. Even 
ou have used a BASIC program to place the bytes in memory, 
y want to record the machine code separately so that youcan 
‘it into the Spectrum without having to load in the BASIC 
m that performs the POKE routines. 
pily, Spectrum, unlike its predecessors, provides for saving 
loading machine code directly though, as you might expect, you 
to be much more specific about what you want. The syntax is 
sed in Chapter 30 of the Spectrum manual, but some 
with one of our programs will give you more confidence in 
of this set of commands. 
use the program that we finished with in Chapter 6, which 
bytes starting at address 32590. The syntax of a SAVE 
for this code will be: 


VE “Count” CODE 32599,9 


your own name for the program of course. When 
you will get the usual message about starting the 
ssing any key. The program saves in much the same 
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way as a BASIC program, so keep a note of where it is on thet; 
that you can wind back to the start again. ; 
To make a fair test, you will then have to switch off 


Having done this, type: 
LOAD “Count” CODE 32500,9 


and when you press ENTER and start the recorder or 
code will be loaded in again, starting at address 325 
the message: 


Bytes: Count 


When the bytes have completely loaded you will get tl 
i:1 message at the foot of the screen when loading is 

There are a number of variations on the LOAD part of 
commands. Using the full version above keeps a careft 
errors, so that if there are more bytes recorded on the taj 
provided for in the length number, you will get an e yr re 
you have forgotten or don’t know how many bytes there ar 
use: 


LOAD “Count” CODE 32569 r 


This will start the loading at address 3259, and load i 
bytes as are recorded on the tape. If yourun out of memory, t } 
~ you'll have to try loading at a different address. Not all pro; 

will still work when they are loaded at a different address, but 


particular one will, so with the program loaded at 32509, 
loading with: 


LOAD “Count” CODE 32596 


This will carry out the loading, starting this time at 32506, 
replacing any bytes that existed previously at these addresses - th 
will be some left over from the program that was loaded in at 32500 
You can now call this program up to check it by using: 


PRINT USR 32596 


which will return with zero after a short delay. 
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What you must not on any account do nowis to use PRINT USR 
3259 again. You might get away with it (in this example you wil 
because of the way the program happens to work), but generati tie i 
result will be a locked out computer, with no keys having any Gh - 
Switch off and start again. ct. 

If you know neither the starting address nor the length of a 
machine code program on tape, then Spectrum can still cope. By 
using the form: 


LOAD “Count” CODE 


with no numbers, the Spectrum will load the bytes into the position 
in the memory that they occupied when they were recorded, which is 
32509 onwards in our example. This is always a safe method 
provided that you have cleared enough memory space. 
Coming back to the idea of loading machine code into a part of 
the memory which is not the same as was used originally, this is 
possible only if the machine code is position independent. Position 
independent code is code which uses no full addresses that are within 
the program or within the range of addresses to which the program 
will be shifted. For example, suppose you have a program which 
starts at 3250 and ends at 32599. If in the program there is an 
| instruction such as JP 32510 or CALL 32577, then these address 
| numbers will be written into the program as code. If you then tried to 
| load this program at addresses 320) to 32099 (assuming that you 
| had cleared enough memory), you would find that it did not runand 
| you would get a lock-up. Why? Because you still have instructions 

JP 32519 or CALL 32577 which refer to addresses where by now 
| there may be completely different codes, or only zeros stored. Code 
| like this can’t be relocated simply, and a similar thing applies if you 
| had a call to 3299 in a program that was placed at 32500; if you 
relocated this program to 3299, you would overwrite the section of 
code which you wanted to call. Relocating a program of this type is 
not possible unless all of these addresses are changed (see Chapter 8 
for relocating programs created with the ULTRAVIOLET 
assembler). If, however, your program had all its jumps in the JR 
ae form and all calls to the operating system which, being in ROM, is 

always at a fixed address that cannot be overwritten, then you could 
such code anywhere in the RAM and runit. This type of code 
catable’, and the LOAD “Name” CODE start address type of 
‘ nd can be used to place it wherever you want it, assuming 

it you have cleared memory for it. 

There is, incidentally,a VERIFY routine for machine co 


og 


de so that 


B the numbers 


PPO DOH 


Case, the three 
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kind of job that is recommended for the beginner, but you can see at 

this stage how the essential parts of it must work. The start bit is sent 

out by loading a 15 into the accumulator and sending it out to port 

254, The reason for using 15 is that it sets bit D3 to 1, and keeps bits 

D2to DO at 1 so that the border does not change colour. A timing 
loop must be used to control for how long this signal issent out, theneach 
bit from the selected byte had to be loaded into the accumulator and 
sent out. How do we do this? One method is to clear the carry flag 
(an OR A will do this), and then rotate the byte in the accumulator 
left. If a 1 is rotated out, the carry flag will be set; if a is rotated out, 
the carry flag will be reset, so that this flag can be tested and used to 
call routines which put out the numbers 15 or 7 according to the bit. 
The delay routine will be used between each of these port output 
operations, and when all eight bits have been sent out (you will have 
to count them!), then two stop signals (1) will be sent, again using the 
same time delay. 

This is a comparatively simple scheme, and it ignores a 
convention called parity, which is used to check for signal 
corruption. Parity means making the number of I’s in a byte always 
either even or odd, according to choice. If you work with even 
parity, the number of I’s in a byte will always be even, and this is 
possible because RS232 is used for ASCII codes which consist of 
only 7 bits. The eighth bit (the most significant bit) can then be set 
or reset to make the total even if even parity is wanted, or odd if odd 
parity is wanted. There is a bit in the status register which can be 
used to check parity, so that elaborate programming is not needed. 
For driving a serial printer, the parity operation can often be 
ignored, and many circuits can work with @ and + 5 V signals in place 
of the -12 Vand + 12 V signals that RS232 strictly should use. 

That’s the easy bit, though. The difficult bit is that the Spectrum 
Stores its listings in compressed form, using the tokens in place of 
keywords, so we can’t send out the bytes simply by reading through 
the memory. Once again, it’s possible if you can find the routines in 
the ROM which are used for listing a program, and there is also the 
possibility of intercepting the signals at the printer port — but this is 
not beginners’ work! 


Chapter Eight 
Debugging and More 


Programming 


Debugging delights 


Now that you have been exposed to the delights of m: 
programming, the time seems ripe to talk about debugging 
a picturesque name for a fault in a program, and debuggi 
process of removing such flaws. There’s probably a 

programmer who put the flaws in place, but our task at 
find how we can best deal with bugs. 

The first part is prevention. Check your flowcha 
make sure that it really describes what you want to 
check your assembly language program equally carefully 
sure that it also does what you expect of it. Then check tha 
that you are placing into memory correspond to t 
language instructions and data. If you do all this you will 
quite a number of bugs before they start to crawl o 
woodwork, Don't fee] that you are a failure if you don’t g 
out - unless a programis very simple, there’s a very good chance 
there will be a bug in it somewhere, and it happens to a of 

If you use an assembler, one very potent source of bugs disappea 
almost instantly. Human frailty means that the proces 
converting assembly language instructions into bytes in mem 
looking up tables is an error-prone business, and by letting 
computer tackle this, a lot of bugs can be prevented, I shall desc’ 
briefly the use of the ULTRAVIOLET © assembler program later 
this chapter. At the time of writing the ULTRAVIOLET was the 
only assembler available for Spectrum, though another was being 
developed which relied on the use of the Microdrive. It is high 
likely that by the time this book appears, a choice of assemblers w 
be available, and if machine code really catches your imagination - 
and you want to branch out into much more advanced work than — 
this book can cater for, then an assembler should be a priority item 
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If, however, you want to use machine code only as a way of 

carrying out minor tasks that are impossible or too slow for BASIC, 
then the POKE-to-memory method that we have used throughout 
this book may be perfectly adequate. It does mean, however, that 
there will be bugs lurking in every corner of the code, The main cause 
of these bugs is tedium. Converting an assembly language program 
into denary bytes is a tedious job, and all tedious jobs generate 
mistakes (ever seen a ‘Friday’ car?). Faulty conversion of hex to 
denary is one possibility, just writing down the wrong figure is 
another which is surprisingly common. One very potent source of 
trouble is in JR or DJNZ displacement values. You may get the 
number wrong, or you may start with them correct and then forget 
that if you add or delete code between the jump start and its finish, 
you will also need to alter the displacement. This again is a problem 
which is solved when an assembler is used. An incorrect jump will 
almost always cause the computer to lock-up or go into its NEW 
routine, and unless you recorded your source routine (the BASIC 
program which POKEd the memory or which holds the assembler 
instructions), or the machine code itself, then you have lost what 
might have been a fair amount of effort. Another form of incorrect 
jump, of course, whichis more difficult to spot, is doing the opposite 
of what you intended, such as JR Z in place of JR NZ. Careful 
thought about what the jump will do for various bytes should 
eliminate this one. 

All of these problems can be overcome by meticulous checking, 
and it pays to be extra careful about JR displacements, and about 
the initial contents of registers. A very common fault is to make use 
of registers as if you could assume that they contained zero at the 
start of the program. You can never assume this — it’s much safer to 
assume that each register will contain some value that will drive the 
program bananas if it is used! What do you do, however, if you have 
checked everything in sight, and the program completely refuses to 
do what you expect? 

There’s no simple answer to that one. It may be that your 
flowchart doesn’t do what you expected it to, and if youdidn’t draw 
one, then you’ve got what you deserved. It may be that you are 
making use of a Spectrum ROM routine, and it doesn’t operate in 
the way that you expect — until we have a complete breakdown of the 
ROM, we simply have to use trial and error. All I can do here is to 
give you some hints about removing the bugs from problem 
programs that seem to be reasonably well constructed but which 
don’t work according to plan. 
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; Ky ry anything new in the midd] a 

The first ang se Js anienibeintn we ciamens ite . 
ee teint ai of which you have thoroughly tested before 
from eee program. In real life, this is not so easy, because 
ernicuniiltal MERGE machine code Anew but it iS still 

ible to load recorded code into sections of memory that are 
Saks to each other, or to MERGE data lines of BASIC 
eomterns, so that more bytes can be POKEd, which is a much safer 
method. If you keep well-tried subroutines on tape, preferably as 
BASIC POKE programs, then you can save a lot of programming 
effort by combining them, remembering that if any of the 
subroutines are non-relocatable, you will have to alter address bytes 
within the program. Once again, users of an assembler have the best 
of all worlds, because if the assembly language instructions are 
stored within REM statements, they can be MERGEd and edited to 
your heart’s content before being assembled. 

Even if you do not use a subroutine library on tape, it helps to 
keep a note of routines. Personal Computer World runs a series 
called SUBSET, which prints several general-purpose machine code 
subroutines each month, and most of these are Z-80 routines, 
reflecting the importance of this microprocessor type. Even if you 
don’t use the routines, the way in which they are documented should 
give you some ideas about how you are going to keep a record of 
your own routines and I personally think that this feature is worth 
my annual subscription by itself. If you are going to use a new 
routine in a program it makes great sense to try it out on its own first, 
so that you can be sure of (a) what you need to have in the registers 
before the program is called, and (b) what you will have in the 
registers after it has run. 

This type of planning should eliminate bugs in a big way, but if 
you are still faced with a program which you don't want to start 
pulling apart, routine by routine, the best method of dealing with it. 
assuming that no good monitor program is available, is to insert 
breaks. A break as far as a Spectrum machine code program is 
concerned, is the RET instruction, coded 21. When this is 
encountered, the contents of the BC register are handed to the 
Spectrum operating system, and normal service is resumed. Now if 
Sen EOE LO, find where the problem lies in a program, the way of 
using a break Is to pick a spot where you want to check a value. This 
Pied seliade ke the other registers, so you will have to add 
ines wove re the RET which will place the contents of that 

e Bisters into the BC pair, The break bytes can then be 
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edited into the POKE part of the program in the DATA lines, and 
the program assembled and tested. When the program reaches the 
breakpoint, it will dump a value into the BC registers and then 
return to BASIC leaving you to chew over the meaning of the 
number that appears. If the program appears to be working well as 
far as this breakpoint, then remove it and put another breakpoint in 
at a later stage. By repeating this process, you should eventually be 
able to find where the fault lies, and this is usually all the clue you 
need to find what the fault is. 

The most awkward faults are faulty loops, because they almost 
invariably cause a lock-up, and on the Spectrum there is no way out 
of this. Some machines have a ‘hardware reset’, a button which can 
be pushed to restore the machine to normal operation even if it has 
become locked into a machine code loop. This is not available on the 
standard Spectrum but it does appear on other Z-80 based 
machines. It is likely, therefore, to be offered by one of the many 
independent hardware suppliers, and it would make life much easier 
for assembly language programmers. 

One fault which can so often cause such an endless loop lock-up is 
a loop back to the wrong position. For example, if we had a program 
such as: 


DIB, 255 
Back: OUT (Port),A 
DJNZ Back 


assembled ‘by hand’, we may have made the DJNZ instruction loop 
back to the LD B,255 instruction rather than to the OUT 
instruction. This will result in the B register being topped up to 255 
each time the loop is executed, so that the DJNZ can never 
decrement B to zero, and so the loop is endless. A mistake like this is 
easily spotted in assembly language, because the position of the label 
name is easily checked, but it can be very difficult to find when you 
can only see the machine code bytes. Once again, taking care over 
loops is the only answer, and the method that has been shownin this 
book of writing the machine code bytes against the assembly 
language instructions is a very good way out of the problem. 


Monitors 


I mentioned monitors briefly a few pages back. It is unfortunate that 
the word ‘monitor’ has come to be used for two different items that 
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assemblers available for the Spectrum as fi i ; 
vachines like the TRS-80. Fie at re 

An assembler is a program, usually in machine code, which has to 
pe loaded like any other program. Thisisa fairly fast operation, even 
when cassettes are used. Once the assembler is loaded, it may present 
you with a menu of options. Typical of these would be entry or 
editing of assembly language, saving or loading of a program written 
in assembly language (known as source code) or one written in 
machine code (known as object code), assembly of source code into 
machine code, and moyement of an editing ‘pointer’ which allows 
lines to be selectively edited. A session of code writing would start by 
the selection of the writing option. 

Each assembler has its own peculiarities, often reflecting 
peculiarities of the machine on which it is used, but most Z-80 
assemblers follow the standards of assembly language that were laid 
down by Zilog, the designers of the Z-80. Rather than deal with 
assemblers in general, however, it’s probably more useful at this 
point to illustrate this section with reference to the first assembler 
that became available for the Spectrum, the ACS ULTRAVIOLET. 


The ULTRAVIOLET assembler 


The ULTRAVIOLET assembler accepts address and data in 
denary, with no hex needed at the writing stage, so that it is easy to 
use with the denary numbers that are shown in the Spectrum 
manual. All of the Z-80 instructions are correctly assembled, and 
code can be placed into memory directly (with some precautions) 
and if necessary relocated. Full listings of the assembly language and 
the code, with the curious mixture of denary for addresses and hex 
for codes can be displayed or sent to the ZX printer, which is 
particularly useful if long programs are being developed. 

The style of the ULTRAVIOLET assembler, however, is very 
similar to that of assemblers for the ZX-81, and it does not take full 
advantage of the ability of Spectrum to make memory space for 
machine-code in high memory addresses. The program also requires 
the assembly language statements to be written inside BASIC REM 
lines, as was used for the ZX-81, and the code is also stored ina 
REM line, the first line of the program. Assembled code can, 
however, be written in a form that will allow it to be recorded and 
correctly relocated to high memory when it is reloaded, with all 
_ addresses corrected. Despite the disadvantages of being modified 
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Chapter Nine 
Last Round-up 


One of the problems of writing a book about machine language 
programming for beginners is knowing where to stop. Volumes 
could be written about Spectrum programming, and still leave room 
for more, so that any finishing point has to be rather arbitrary. My 
aim has been to introduce machine code programming of Spectrum 
jn such a way that the reader can then progress to much more 
specialised books. This chapter is concerned with tying up loose 
ends, mentioning a few more instructions, and illustrating how to 
make use of some more features of the Spectrum. 

We'll start with another set of Z-80 instructions, the block-shift 
set. Block-shift is a good summary of what these instructions are 
about - the ability to move code from one part of memory to another 
simply by setting up registers with memory addresses and using a 
single assembly language instruction. A list of these codes, with a 
brief explanation of what each one does is shown in Fig. 9.1 , and 
since they are so similar to each other in operation, we'll single one of 
them, LDIR, out for demonstration. 

LDIR is a shortened version of Load, Decrement, Increment 


Mnemonic Action 


LDI Place HL contents into DE 
address, increment HL and DE, 
Decrement BC. 


LDIR As for LDI, but repeats until 
BC contains zero. 
LDD As for LDI, but registers HL 
and DE are decremented. 
LDDR As for LDD, but repeats until 
oe BC contains zZeYTO+ 


Rigeat., The: block-shift commands of the 2-80. 


a 
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VIDEO EQU 16384 
LENGTH EQU 6143 
START: LD HL, VIDEO 
LD DE, VIDEO + 1 
LD BC, LENGTH 
LD (HL), 68 
LDIR 
RET 


1M CLEAR 32500: LET j = 325900 

20 FOR n = # TO 13: READ b 

30 POKE j +n, b: NEXT n 

49 LET z = USR j 

19 DATA 33, 0, 64, 17, 1, 64, 1, 
PSone a 5408237, 1765, 200 


Fig. 9.3. Using LDIR to produce a screen pattern. Try this for speed! 


Fig. 9.3 illustrates this program instruction at work in an 
application which produces a pattern on the Spectrum screen. The 
number which is loaded into the HL register pair is the start of the 
display file of Spectrum, so that the loading to these addresses will 
cause something to appear on the screen. The DE registers are 
loaded with the next address up from the one held in HL, and BC is 
loaded with the number of bytes to transfer - a number which is the 
difference between the end and the start addresses of the display file, 
less one. The first address, the one held in HL, is then loaded with the 
byte 68 denary, which corresponds to the binary number 61999 100. 
When the LDIR action starts, the byte 68 which is held in address 
16384 is copied into 16385. The BC register then decrements, the HL 
address increments to 16385 and the DE address increments to 
16386, Next time round, the byte which has been placed into 16385 is 
copied into 16386, and this ‘bucket-chain’ process continues until the 
whole of this section of memory has been filled with the byte 68. 
Convert this one into bytes for yourself, and watch it run — it’s a 
powerful demonstration of how fast machine code can be for 
purposes like this. This is why machine code is preferred for writing 
fast-action games. The screen can be cleared and the action called up 
each time you want it by typing LET x= USRj, or RANDOMIZE 
USR j, If you use PRINT USR J, then the number @ will appear at 
the top left hand side of the screen which rather spoils the effect. If 


you feel that a finer grid would look better, try the number 85 in 


Place of 68; the clue to the pattern is the appearance ofthe I’s and 9's 
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i iable name * 
C nds of the Z-80 to find the varia! 
pene mber variable, is coded as its ASCII code | 


and-report command is CPIR, which is a block-searc ‘command 
and a summary of this group of commands is illu trated in r 

CPIR will search through a specified block of memor 
looking for a matching byte. The address of the start 
memory is put into HL, the byte that you want to 
maximum number of bytes that you want to search 
Using the CPIR code (which is a two-byte code) then: 
at the address held in HL to be compared with th 
accumulator, and if no match is found, the HL re; 
incremented, the BC pair decremented, and the 
until either a match is found, or the BC register c 

Fig. 9.6 shows the flowchart for this program. 
make any use of the variable value in this example, b 
moment we are more interested in how to find it ra 
do with it! The key parts of the flowchart are gett 
the variable list table, searching for the address at w 
name is located, and then shifting to the address y 
the value are stored. If we confine ourselves to i 
numbers less than 65535, the number will be sto 
only, and these can then be loaded into the BC registe 
can print the number on the screen as confirmation 
found it. 

The CPIR instruction will leave the value of t 
incremented, so that it has gone one step beyond th 
variable name when the name of the variable has bee 
two more increment steps will therefore be needed 
address of the low byte of the value. 


simple nu 


address, is loaded into the D register, This leaves DE h 
address of the variable list table, with the bytes in the corr’ 
high byte in D, low byte in E. We shall, after one more in 


a HL, so that HL will now hold the address of the start of the 
se “ list table, and DE will hold the address 23628, which do 
Interest us any longer. This Swap command is used extensively W 


Last Round-up 119 


LD HL, 23627 3 pointer to vy, 
LD E, (HL) Paeee lowes stapees table 
INC HL 5 bump up address 
LD D, (HL) 3 get higher byte 
LD BC, FFFFH 3 Maximum count 
EX DE, HL 5 get start of 
into HL ace 
LD A, 119 3 byte to recognise 
cPIR 5 look for it! 
INC HL = move to ... 
ENGEL 3 value, twice 
LD C, (HL) ; low byte toc 
INC HL 3 point to high byte 
LD B, (HL) 3 high byte to B 
RET 3 back to BASIC 


Fig. 9.7. The assembly language program for finding the variable name 


addresses are being assembled, because we always try to work with 
important addresses in HL rather than in the other register pairs. 

In this example, BC has been loaded with the maximum possible 
count number. In practice, it might be wiser to limit this to a smaller 
quantity to avoid long searches for non-existent variable names. A 
further refinement is to print an error message if the variable is not 
found, which means if BC is decremented to zero with no match 
found. Error messages can be called by putting the error message 
code number into the memory following a RST 8 command. For the 
sake of example here, however, the maximum length for BC has 
been used - it also stops the program from growing beyond the 
bounds of a beginner's exercise! Remember — if you should change 
the value in BC — that BC must still be loaded with two bytes. So, if 
you want to search 10¢ bytes only, you must use 1,190,0 , where lis 
the LD BC,NN code, and the two following are the bytes of the 
number, 

We now use CPIR to search for a byte equal to 110. This makes 
the program rather vulnerable, because if the variable list table 
contains a lot of entries preceding the entry for n, and one of these 
happens to be one which contains the number 110 (such as LEP s= 
119, or, less obviously, LET s= 28165, which is 5 + 256*119), then 
the address of this value will be found rather than the address of the 
Valuc of n. This can be avoided by making the program considerably 
more elaborate, but we’re trying to illustrate principles here, not to 
show off. If you want a clue, a good one is to look at the most 


_ Significant three bytes of the first variable name, and use this to jump 
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and so on. This can’t be done 
which is why I want to illustrate the simple method. 
Once the address has been found, rememberin, 
contains an address one higher than the address t 
name, we can increment HL twice to find the low byte of 
n. This is put into C, HL is incremented again, and 
which is the high byte, is put into B. Onreturn, then, B 
the value that we are looking for. 


directly to the next one, 


19 CLEAR 32500 
26 LET n = 240 
39 GO SUB 1900 
40 PRINT USR j 
50 GoTo 9999 


1900 LET j = 32500 
1919 FOR x = # TO 19: READ b 


1920 POKE j + x, b: NEXT x 

1939 RETURN ae 

1940 DATA 33, 75, 92, 94, 35, 86, 1, 
a5 Neossero2s 10, 237, 177, 
78, 35, 76, 201 


Fig. 9.8. The BASIC POKE version of the vai 


which is called at line 39 will find this value. Values b« 
65535 can be used for n, but fractions and negative numbe 
be avoided. 

The usefulness of this method does not end with pa 
number variable value. Since the program finds the ad 


modifications, to find the names of string variables, numb 
or string arrays, providing you remember how these ne 
coded (see Chapter 2). For example, if a number array is to| 
the variable name is followed by a count number. This can be 
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‘ aed ctrum ROM, and can just as easily be ca} 
Sng BASIC. he fal that they run slower in BASIC js tiny 
seldom a real disadvantage. Any program that requires a lot of 
arithmetic is therefore better written in BASIC, unless it woulg run 
so painfully slowly that it would be unusable — some of the 
‘spreadsheet’ financial programs fall into this class. Where machine 
code really comes into its own is when you want high speed, perhaps 
for graphics work, or for actions which don’t exist normally, like 
sending serial printer bytes out from the cassette port. At some stage 
during the development of a program, you will have to decide 
whether it should be written entirely in BASIC, or mainly in BASIC 
with some machine code sections, or entirely in machine code. 
Unless you have an assembler, I would strongly advise you not to 
tackle any program entirely in machine code unless it is fairly short, 

Many programs, then, can best be tackled by interleaving bits of 

machine code with other sections of BASIC. The USR address 
method of accessing machine code that the Spectrum uses is a 
recognition of this, so it’s wise to take advantage of this provision 
For many programs that make use of graphics, only those parts 
which require rapid movement, or very fast filling of the screen (or 
part of it) need to be written in machine code. Several blocks of 
machine code can be held in the RAM, providing enough space has 
been reserved; and each can be called by putting its starting address 
following the USR command, allowing you the choice of placing as 
many machine code sections as you want in with your BASIC steps. 
Passing variables to the machine code routine (another method will 
be illustrated later) means that you can attempt actions like starting 
a screen-fill routine at a place on the screen that can be specified by 
the value of a variable, or movinga pattern ata speed that is decided 
by another variable values (because it is used asa count variable ina 
DJNZ delay loop). 

The important thing to avoid is writing machine code for its own 
sake. Machine code can become hypnotically fascinating, and it is 
very tempting to embark on very large programs simply to convince 
yourself that you can master this language. It’s a temptation that has 
to be avoided unless you have time and the inclination to do it. If 
your object is simply to produce efficient programs, then a mixture 
of BASIC and machine code is probably a better bet. If you want to 
spend your time generating fast-action games programs, then it 
might be more profitable to look at alternatives to BASIC, such as 
FORTH, rather than working directly in machine code. Choose the 
right horse for your course, and you will be on to a winner. 
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particularly in those which renumber BASIC lines. It’s also by far 
the most elaborate program that we shall look at in this book, 
making me wish that I had been able to get hold of an assembler 
rather earlier! de 

As a ‘front end’, I have used the utility we have already developed 
_ the one which places into BC the value ofan integer whose name is 
‘n’, This is certainly not the only way of putting this value into place, 
Later on we shall look at a much simpler method, but I want to show 
how one section of subroutine can be joined to another to make a 
longer program. The variable value finder, remember, puts the value 
of the integer variable into the BC register pair. Since line numbers 
are always positive integers, this will do very nicely, thank you, and 
we'll use the whole routine as it is. The next stage, then, is to designa 
program which will go through the lines one by one, checking the 
line numbers, until it finds line number bytes that match the bytes in 
BC. For the moment, we won't worry about what the program does 
if it doesn’t find the numbers! 

The flowchart is shown in Fig. 9.10. The first item is to find the 
starting address of the BASIC program. This is done by placing the 
address taken from reserved RAM into the HL pair. When we have 
the start address, we know that the first two bytes of code will be the 
first line number, in unorthodox high-byte, low-byte order. We can 
therefore extract these and compare them with the bytes we have 
stored in BC, which are the line number bytes handed on by the 
variable finder part of the program. We can’t compare both at once, 
so this has to be a two-step business; the flowchart doesn’t have to go 
into such detail. If the bytes match, then the address bytes from HL 
are put into the BC register pair, and the program returns to BASIC 
so that the address in the BC pair will be printed. If there is no match, 
then we have to read the next two bytes of the line. These form a 
‘displacement’ number which will give us the address of the end of 
that line. The start of the next line is one address number higher, and 
once we have incremented the address, we can return to repeat the 
whole checking process. 

The flowchart in this example contains no fine details, and the 
assembly language is not quite such a good match with the flowchart 
as earlier examples were. When you are unsure of how to carry out 
any single flowchart item, it's a good idea to draw a more detailed 
flowchart just for thar item — it’s always time well spent. As an 
illustration, look at Fig. 9.11, which shows details of the 
COMP. ARE and MATCH stages of the flowchart. The reason for 
this is that two comparisons are needed, One is a comparison of the 
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address, then, we get the msb of the line number, and we can 
compare it with the msb of the wanted line, which is in the B register 
Before we act on this comparison, though, we increment the additess 
number in HL, since this saves complications later. This is one of the 
operations which does affect flags in the status register, so that we 
can follow it with JR NZ, using the flags that were affected by the 
comparison to jump toa ‘find-next-line’ routine if the bytes were not 
equal, 

Very often, the msb’s will be equal. They will be equal, for 
example, if the BASIC program has no line numbers greater than 
255 and you have not asked for a number greater than 255. We then 
have to test the Isb’s. lhis is done in the same way, using CP C, and 
then JR NZ to jump to the ‘find-next-line’ routine if these numbers 
are unequals. If a match is found, then the HL address has to be 
decremented again to point to the start of the line, and the bytes in H 
and L are transferred to B and C (note that there is no convenient EX 
BC,HL command) so that they can be returned to the BASIC 
program. 

If no match has been found, the routine which starts at the label 
‘next’ will find the starting address of the next line. The HL value is 
incremented, so that the address is now that of the Isb of the 
displacement, and this number is put into register E. HL is 
incremented again, and the byte at this new address is put into 
register D. By adding DE to HL and incrementing again (because 
DE + HI gives the address of the end of the line), we get the start 
address for the next line, and we can then repeat the comparison by 

jumping to the label word ‘comp’. 

This is about the length of program at which you start to want to 
use an assembler! It’s rather tedious to assemble ‘by hand’, and more 
tedious to sort out, so that you can try it and decide for yourself by 
trying some modifications if this is the life for you. Before we end, 
however, I would like to point out one drastic simplification. 

This concerns getting the line number into BC. In the program as 
it is used at present, we have made use of the variable finder routine, 
but this has snags. One of the main snags is that it forces us to have 
‘n’ as the first variable in the list table, in case the same number 
appears anywhere else in the table. Ideally, we would like GOSUB 
199 to appear in the first line of the program, assembling the code 
into memory once only and thereafter using it. This would greatly 
speed up the program because, as it is shown in Fig. 9.13, it carries 
out the POKE to memory each time the program runs, which wastes 
time. If, however, we run the subroutine once only, we shall place 
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The coding of integers has been dealt with in the text, and this 
appendix, which is for the strong in heart (and maths) only, deals 
with the coding of non-integers, or ‘floating-point’ numbers, A 
denary number can be represented in ‘scientific’ or ‘standard’ form 
as N X 10°, where N isa number less than 10 (and which can contain 
a fraction) and n is an integer, positive or negative. In this form, the 
number 10200 becomes 1.02 X 10°, and the number 0.000345 
becomes 3.45 X 10°. N is called the mantissa, and n is called the 
exponent when this scheme is used. Its advantage is that it makes 
very large or very small numbers easier to deal with. 

The binary form of this notation is used for floating-point 
numbers. The mantissa uses four bytes, and the exponent uses one 
byte, but the digits that are placed in these bytes are not simply the 
digits of the numbers. To start with, the first byte of the number is 
the exponent to which has been added 128 (80H). The next four 
bytes are used for the mantissa, which is a binary fraction whose 
denary value lies between 0.5 and I, never actually reaching |. The 
first bit of this mantissa is always I, so that it can be used as a sign bit. 
If it is replaced by a zero then this signals a positive number, but 
leaving it as a I signals a negative number. The exponent will be 128 
or more for a number of 1 or more, and less than 128 for a fraction 
with no whole-number part. 

The value of the mantissa hinges on how a binary fraction is 
written, Just as we use the places ina binary number which isa whole 
number to represent positive powers of two (1,2,4,8,16,32,64.. -), 80 
we can use places after the binary (not decimal!) point to represent 
negative powers of two, 0.5,0.25,0.125,0.0625.... corresponding to 
Y,, Ya, Vy, Yyo, etc. The binary fraction .101001 is therefore 0.5+ 0.125 
+ 0.015625 (5 + , + Yq) = 0.640625. 

A number is converted into this form by dividing it by the nearest 
(larger) power of two. For example, the denary number 1.64 is larger 
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697 Z-80 Operating 
Codes, with Mnemonics, 


Hex Codes, Denary Codes 
and Binary Codes 


The following list of all 697 Z-80 operating codes, with mnemonics, 
hex codes, denary codes, and binary codes consists of four columns, 
Where a code consists of more than one byte, the bytes have been 
arranged vertically, to avoid confusion. Where a data byte, 
displacement byte, or address has to be inserted, this is shown by 
using 00 for a data or displacement byte, or 0000 for an address. 
Customarily, this is shown on such lists by using N for a single byte 
of NN for an address (hence the position of these items in the 
otherwise alphabetical listing), but because a hex to denary and 
binary conversion program was used to produce the lists, letters 
such as N could not be used in the program. 

The very considerable labour of producing such a list means that 
inevitably some mistakes are made during compiling the list. I have 
eliminated these are far as I know, but I shall be grateful if any errors 
are brought to my notice. 
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‘ape A, ‘HL? BE 142 10001110] AND (TY+00) 


ape A. (1x+00) DD 221 11011101 FD 253 11111101 
BE 142 10001110 A6 166 10100110 
a0 0 0000000 | aND A ee 90000000 
ppc 6, (1Y+00) FD 255 11111101] aND B 87 167 10100111 
SE 142 10001110] AND Cc RO 160 10100000 
00 ©  d0000000| aNnD D 3 161 10100001 
apc A.A 8F 143 10001111] AND 00 ee 162 10100010 
apc A.B 8a 136 10001000 Sol oe iisento 
ape A.C 89 137 10001001 | AND E SD ee Sata 
apc A.D 8A 138 10001010] AND H ah see oa 
apc A,00 CE 206 11001110] pnp L as beepers Ul eC) 
00 (0 00000000 | BIT 0, (HL) cB oe iionees 
apc A,E 8B 139 10001011 Wa ag ae 
‘apc A.H 8C 140 10001100] BIT 0,(1xX+00) DD 271 aeons 
ADC A,L 8D 141 10001101 GE) Bosh. tretie 
‘Apc HL. BC ED 237 11101101 Pe re SPOCLGTT 
4A 74 1001010 Ade Poe son aoe 
ADC HL, DE ED 237 11101101| BIT Oo, (IY+00) FD 253 Seti, 
5A 90 01011010 CB 208 11001011 
ADC HL, HL ED 237 11101101 00 0 Seinen 
68 106 01101010 46 70 GineceNa 
ADC HL,SP ED 237 11101101] BIT o,A een con tena 
7A 122 01111010 47 71 1000111 
ADD A, (HL? 86 134 10000110] BIT 0,B CB 203 11001011 
ADD A,(1X+00) DD 221 11011101 40 64 01000000 
86 134 10000110] BIT 0,c CB 203 11001011 
oo 60 90000000 41 65 01000001 
ADD A, (1Y+00) FD 253 11111101] BIT 0,D CB 203 11001011 
86 154 10000110 42 66 01000010 
co 0 90000000 BIT O,E CB 203 11001011 
ADD A.A a7 135 10000111 45 67 01000011 
ADD A,B 80 128 10000000 | BIT 0,H CB 203 11001011 
ADD A,C 81 127 10000001 44 68 01000100 
ADD A,D g2 130 10000010 BIT O,L CBR 203 11001011 
ADD A,00 C6 198 11000110 45 69 01000101 
00 © 90000000 | BIT 
ADD A,E 83 151 10000011 ee Ne get Set gaan 
ADD A,H 84 152 10000100] BIT 1,(I1x+00) DD 221 11011101 
ADD A,L 85 1355 10000101 CR 205 11001011 
ADD HL,BC 09 9 0001001 02 © — aa0a0000 
ADD HL, DE 19 25 ooot11001 4E 78 1001110 
ADD HL,HL 27 41 0101001 | BIT 1,¢IY+00) FD 255 11111101 
ADD HL,SP 39 57 00111001 CR 203 11001011 
ADD Ix,BC DD 221 11011101 eo 60 ecooco00 
°F 9  a0001001 aE 78 01001110 
ADD IX,DE DD 221 11011101] BIT 1,A CR 203 11001011 
19 25 00011001 4F 79 1001111 
ADD 1X, 1x DD 221 11011101] BIT 1,8 CR 203 11001011 
29 41 90101001 48 72 01001000 
DD 221 11011101 | BIT 1,C CB 205 11001011 
39 57 90111001 49 73 1001001 
FD 255 11111101] BIT 1,D CB 205 11001011 
0? 9  g0001001 4a 74 01001010 
FD 255 11111101 | BIT 1, CB 205 11001011 
19 25 00011001 4B 75 01001011 
FD 255 11111101 | BIT 1,H CR 203 11001011 
29 41 00101001 4C 76 01001100 
FD 253 11111101 BLY 1,b CR 203 11001011 
39 57 0111001 4D 77 01001101 
Aé 166 10100110] BIT 2,(HL) CR 203 11001011 
DD 221 11011101 56 86 a1010110 
AG 166 10100110] BIT 2,¢IxX+00) DD 221 11011101 
00 0 oaoa0000 CB 203 11001011 


90 60 00000000 
5é 86 01010110 
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BIT 4,0 
). Fl 253 11 111101 
BIT 2, (ty+00) Fh 208 11001011 


oo 0 00000000 
56 86 1010110 


BIT 5, (HL) 


BIT 5, (1X+00) 


a CB 203 11001011 
pear 57 87 o1o01014i1 
BIT 2,B CB 203 11001011 


SRSSshsae 


010000 
ist 38 qroonoa1 BIT 5, (1¥+00) 


203 
hs 51 @1 01010001 cB 
BIT 2,D cB 203 11001011 
52 982 091010010 
BIT 2,E CB 203 11001011] BIT 5,4 
53 83 01010011 ‘ 
BIT 2,H CB 203 11001011] BIT 5,B 
S54 84 01010100 
BIT 2,L cp 203 11001011] BIT 5,C 
55 85 01010101 
BIT 3, (HL) cB 203 11001011 | BIT 5,D 


SE 94 01011110 

BIT 3,(1X+00) DD 221 reat BIT S,E 

203 11 

ae Qo 00000000 BIT 5,H 
BE, 01011110 

BIT 3,¢1¥Y+00) FD 253 11111101 BIT S,L 
CR 203 11001011 
oo 60 eo0egece | BIT 4, (HL) 
SE 94 01011110 


BIT 3,A CB 203 11001011 | BIT 6, (Ix+00) 
SF 95 01011111 

BIT 3,B CB 203 11001011 
58 88 01011000 

BIT 3,C CB 203 11001011] BIT 4, (TY+00) 
59 89 1011001 

BIT 3,D CB 203 11001011 
SA 90 01011010 

BIT 3,£ CB 203 11001011] BIT 6A 
SR 91 01011011 

BIT 3,H CB 203 11001011] BIT 6,B 
5C 92 01011100 

BIT 3,L CB 203 11001011] BIT 6,C 

| 5D 93 01011101 
BIT 4, (HL) CB 203 11001011 | BIT 4, 


66 102 01100110 

BIT 4,(IX+00) DD 221 11011101 |] BIT & 
CB 203 11001011 
00 0 00000000 | BIT 6 
66 102 01100110 

BIT 4, (1Y+00) FD 253 11111101 | BIT 6,L 
CB 203 11001011 
00 0 00000000 | BIT 7, (HL) 
66 102 01100110 


BIT 4,A CB 205 11001011 | BIT 7, (1x+00) 
67 103 01100111 

BIT 4,B CB 205 11001011 
60 96 01100000 

BIT 4,C CB 203 11001011 | BIT 7, (TY+00) 
61 97 01100001 

BIT 4.D CR 203 11001011 
62 98 01100010 

BIT 4,£ CB 203 11001011 | BIT 7,q 
63 99 01100011 

BIT 4,H Ce 203 11001011 | BIT 7,B 110010 


a 
64 100 01100100 1111000 


205 11001011 
121 O1111001 
203 11001011 
122 01111010 
205 11001011 
125 O1111011 
205 11001011 
124 01111100 
11001011 
125 01111101 
205 11001101 
is) 00000000 
220 11011100 
Qo 0000000 
252 11111100 
° 20000000 
212 11010100 
Qo 0000000 
244 11110100 
F 00 0 90000000 
| PE,0O EC 256 11101100 
00 0 0000000 
PO, 00 E4 228 11100100 
bs eo 0 20000000 
2,00 cc 204 110901100 
\ 00 0 a0000000 


BSSZASSSSSRARSESBIE 


SF 635 00111111 
BE 190 10111110 
DD 221 11011101 
BE 190 10111110 
a0 0 00000000 
FD 253 11111101 
BE 190 10111110 
00. 60 aGg000000 
Be A958 POLAT 11 
BB 184 10111000 
BY 185 10111001 
BA 186 10111010 
FE 254 11111110 
00 9 00000000 
BR 187 10111011 
BC 10111100 
BD 10111101 
ED 11101101 
AP 10101001 
11101101 
10111001 
11101101 
10100001 
11101101 
10110001 
oo101111 
ootoo111 
00110101 
11011101 


ex 
FX (SP) HL 
EX (SP) IX 


EX (SP) IY 


IN A, (C) 
IN A,PORT 
IN B, (C) 
IN €, (C) 
IN D, (C) 
IN E, (C) 
IN H, (C) 
IN L, (C) 
INC (HL) 


INC (1X+00) 


INC (1Y+00) 
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15 
iB 
1D 
25 
2B 
DD 
2B 
FD 
2B 
2D 
3B 
FS 
10 
00 
FB 
8 
es 
DD 
ES 
FD 
ES 
08 
EB 
De 
76 
ED 
46 
ED 
56 
ED 
SE 
ED 
78 
DB 
00 
ED 
40 
ED 
48 
ED 
50 
ED 
58 


00010101 
90011011 
00011101 
90100101 
00101011 
11011101 
00101011 
11111101 
90101011 
00101101 
oO111011 
11110011 
00010000 
90000000 
11111011 
10001000 
11100011 
11011101 
11100011 
11111101 
11100011 
00001000 
11101011 
11011001 
01110110 
11101101 
91000110 
11101101 
01010110 
11101101 
01011110 
11101101 
1111000 
11011011 
Felelererererere) 
11101101 
91000000 
Liia1iodL 
01001000 
11101101 
01010000 
11101101 
91011000 
11101101 
91100000 
11101101 
01101000 
90110100 
11011101 
00110100 
QoAE0000 
11011101 
90110100 
9000000 
0111100 
0000100 
Fererererexes Bt 
90001100 
90010100 
QoaLOOL 
00011100 
20100100 
OOLOOORL 
1LOML1OL 
OOLOOOLT 
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INC IY 
INC L 
INC SP 
IND 
INDR 
INT 
INIR 


JP (HL) 
JP(IX) 


gpry) 


J 0000 


JP C,0000 


JP m,0000 


JP NC,OO000 


JP NZ,0000 


JP P,0000 


JP PE,0000 


JP PO,9000 


JP Z,0000 


JR C,00 
JR 00 

JR NC,0O 
JR NZ,00 
JR Z,00 


LD<0000) ,A 


LD<0000) , BC 


LD‘0000) , DE 


FD 
23 


253 
35 
aa 
Si 
237 
170 
237 
186 
237 
162 
237 
178 
235 
221 
235 
255 
235 
195 


11211101 
90100011 
00101100 
oo110011 
11101101 
10101010 
11101101 
10111010 
11101101 
10100010 
11101101 
10110010 
11101001 
11011101 
11101001 
11111101 
11101001 
11000011 
00000000 
90000000 
11011010 
00000000 
00000000 
11111010 
90000000 
00000000 
11010010 
90000000 
90000000 
11000010 
99000000 
90000000 
11110010 
90000000 
20000000 
11101010 
90009000 
0000000 
11100010 
90000000 
90000000 
11001010 
90000000 
90000000 
00111000 
00000000 
00011000 
00000000 
90110000 
00000000, 
00100000 
0000000 
00101000 
90000000 
00110010 
90000000, 
00000000 
11101101 
01000011 
909000000 
90000000 
11101101 
01010011 
90000000 
09000000 


LD(Q000) , HL 


LD (0000) , HL 
LD (0000) , IX 


LD(a000) , IY 


LD(Q0Q00) , SP 


LD(BC).A 
LD(DE) A 
LD(HL) A 
LD(HL) ,B 
LD(HL) ,C 
LD(HL) ,D 
LD(HL) ,00 


LD(HL) ,£ 
LD(HL) .H 
LD(HL) ,L 
LD(IX+#00) A 


RN ee 
QeNoa 


LD(IX+00) ,B 


‘54 
i 
1 
1 
1 
2 
x 
9 
2 
ee 


LD(IX+00) ,C 


LD¢1xX+00) ,00 


LD(IX+00) ,E 
LD(IX+00) ,H 
LD(IX+00) ,L 
LD(Iy+00) A 
LD«1Y¥+00),B 


LD(1Y+00) ,¢ 


LD(Ty+00),D ol 
; 01110010 


9EEQ0000 
LD(IY+00) ,00 


Pererereen ens 
aooo0o0e 


7 


LD(TY+00) ,E 
LD(ry+o0) .H 
LD(ry+o0).L 
LD A, ca000) 


LD A, (BC) 
LD A, (DE) 
LD A, (HL) 
LD A, (1¥+00) 


5 


A, (1X+00) 


A.A 
A.B 
asc 
a.D 
A, 00 


AE 
A,H 
Ast 


655 65655 


AL 
ASR 


B, (HL) 
B, (1X4+00) 


66 65 


5 


B, (TY+00) 


6566 G&GES 


LD BC, 0000 


LD C, (HL) 
LD C, (1x+00) 


LD C, (1y¥+00) 


a 
o 


11111101 
O1110011 
0000000 
11141101 
91110100 
00000000 
11111101 
O1110101 
20000000 
90111010 
00000000 
90000000 
00001010 
00011010 
01111110 
11011101 
01111110 
90000000 
11111101 
o1111110 
00000000 
Oiiii1i1 
01111000 
01111001 
01111010 
00111110 
00000000 
01111011 
01111100 
11101101 
01010111 
01111101 
11101101 
01011111 
019000110 
11011101 
01000110 
90000000 
11111101 
01900110 
oa000000 
01000111 
019000000 
o1000001 
91000010 
00000110 
00000000 
o1000011 
01000100 
01000101 
11101101 
01001011 
00000000 
90000000, 
90000001 
90000000 
00000000 
91001110 
11011101 
91001110 
90000000 
11111101 
01001110 
00000000 


LD D 


LD 


HL) 
1X+00) 


narEm 


DE, 0000 


E, (HL) 
E, (1X+00) 


E, (1Y¥+00 


H, (1X+00) 


H, (LY+00) 


as Sp SUE SP Se ie eee 


rim gocmpD 
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01001144 
01001000 
01001601 
91001010 
90001110 
00000000 
91001011 
91001100 
01001101 
91010110 
11011101 
01010110 
00000000 
11111101 
01010110 
90000000 
o1010111 
91010000 
01010001 
01010010 
90010110 
00000000 
01010011 
01010100 
01010101 
11101101 
o1o11o0i1 
20000000 
a0000000 
00010001 
00000000 
90000000 
o1011110 
11011101 
01011110 
oa000000 
11111101 
Q1011110 
oog00000 
o1oiiiii 
01011000 
01011001 
01011010 
Q0011110 
0000000 
g1o110i1 
01011100 
01011101 
O1100110 
11011101 
01100110 
90000000 
11111101 
Q1100110 
eea00000 
o1100i1il 
1100000 
91100001 
01100010 
90100110 
Eade00d 
o1100011 
O1100100 
91100101 
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LD 


Lb 


Lb 


LD 


LD 


LD 


LD 


LD 


Lb 


LD 


HL, 0000 


HL, (0000) 


HL, 0000 


1,A 


1x, (9000) 


1x, 0000 


Ty, (0000) 


IY, 0000 


L, (HL) 


L, (IX+00) 


L, (Iv¥+00) 


—D 
6B 
00 
00 
2A 
a0 
00 
21 

00 
90 
ED 
47 
DD 
2A 
90 
0 
DD 
21 

00 
90 
FD 
2A 
00 
00 
FD 
21 

00 
00 
6E 
DD 
6E 
00 
FD 
6E 
oo 
oF 
68 
69 
6a 
2E 
oo 
6B 
6c 
6D 
—D 
4F 
ED 
7B 
00 
a0 
31 
a0 
90 
Fg 
DD 
Fg 
FD 
Fg 
ep 
ag 
ED 
Bg 
—D 
#0 


237 
107 
Qa 

ie) 
42 


11101101 
01101011 

00000000 
90090000 
00101010 
00000000 
90000000 
00100001 
90000000 
0000000 
11101101 
1000111 
11011101 
00101010 
0000000 
90000000 
11011101 
00100001 
00000000 
0000000 
11111101 
90101010 
00000000 
90000000 
11111101 
00100001 
00000000 
0000000 
01101110 
11011101 
01101110 
0000000 
11111101 
01101110 
90000000 
01101111 
01101000 
01101001 
01101010 
00101110 
09000000 
01101011 
01101100 
01101101 
11101101 
01001111 
11101101 
O1111011 
0000000 
02000000 
00110001 
90000000 
00000000 
11111001 
11011101 
11111001 
11111101 
11111001 
11101101 
10101000 
11101101 
10111000 
11101101 

10100000 


LDIR 
NEG 
NOP 


OR (HL) 
OR(IX+#00) 


OR(TY+00) 


OR A 
OR B 
OR C 
OR D 
OR oO 
OR —& 

OR H 

OR L 

OTDR 

OTIR 
QUT(C).A 
OUT(C),B 
QUT <(c),c 
QUT(C),D 
OUT(C),E 
QUT (C) ,H 
QUT(C),L 
OUT (Port) ,A 
OUTD 

OourTrI 

POP AF 

POP BC 

POP DE 

POP HL 

POP Ix 

POP Iy 
PUSH AF 
PUSH BC 
PUSH DE 
PUSH HL 
PUSH IX 
PUSH Iy 

RES ©, (HL) 


RES 4, (1X+00) 


11101101 
10110000 
11101101 
91900100 
00000000 
10110110 
11011101 
10110110 
90000000 
11111101 
10110110 
00000000 
10110111 
10110000 
10110001 
10110010 
11110110 
90000000 
10110011 
10110100 
10110101 
11101101 
10111011 
11101101 
10110011 
11101101 
01111001 
11101101 
01000001 
11101101 
01001001 
11101101 
01010001 
11101101 
01011001 
11101101 
91100001 
11101101 
01101001 
11010011 
20000000 
11101101 
10101011 
11101101 
10100011 
11110001 
110900001 
11010001 
11100001 
11011101 
11100001 
11111101 
11100001 
11110101 
11000101 
ALo1o1e1 
11100101 
ALO11101 
11100101 
Ai111101 
11100101 
tigre! 
1Eood1 Le 
11041101 
r1901elt 
EQE00000 
EQDADEO 
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RES 0, (1Y#00) FD 253 11111101) RES 2,1 


an CB 203 11001011 Se 203 11001011 
; 00 9 do000000] RES s,«m» 22 149 10010101 
¥ 00 6  cda000000 = 203 11001014 
f RES 0,8 GB 205 11001011] RES 3, (Ix+00) pp 25; 10011110 

87 135 10000111 cn 11011101 
RES 0,B CB 203 11001011 00 ~ 11001011 
80 128 10000000 BES dee aes 
at aes Leceuees | Settroo oo ES itd 
Ci 
RES 0,D CR 203 11001011 a Se enor 
82 1350 10000010 Seu aa ee 
RES 0,£ ee 203 11001011 | RES 3,4 CB 203 ttdciaes 
S131 10000011 Se ise 
RES 0H CB 203 11001011 | RES 3,8 eect 
84 132 10000100 98 152 1 
RES O,L CR 203 11001011 | RES 3,c GB) Sasa araioe 
85 133 10000101 99 153 100 
RES 1, (HL) CER 205 11001011 | RES 3,D CB 205 neers 
BE 142 10001110 GA 154 1001tdio 
RES 1.(IX+00) DD 221 11011101 | RES 3,£ CB 203 11001011 
CBR 205 11001011 9B 155 10011011 
00 0 0000000 | RES 3,H CB 203 11001011 
00 0 a0000000 9C 156 10011100 
RES 1,(1¥+00) FD 253 11111101 | RES 3,L CB 203 11001011 
CB 203 11001011 9D 157 10011101 
00 0 oo0o000e | RES 4, (HL) CB 203 11001011 
oo 0 00000000 AG 166 10100110 
RES 1,8 CR 203 11001011 | RES 4,(IxX+00) DD 221 11011101 
GF 145 10001111 : CB 203 11001011 
RES 1,8 CB 203 11001011 oo 9 00000000 
88 134 10001000 A6 146 10100110 
RES 1,C CR 203 11001011] RES 4,(1Y+00) FD 253 11111101 
8? 137 10001001 CB 203 11001011 
RES 1,D CB 203 11001011 oo 60 oa000000 
8A 138 10001010 AS 1646 10100110 
RES 1.£ CB 203 11001011 | RES 4,A CB 205 11001011 
SB 139 10001011 AZ 167 10100111 
RES 1,H CB 203 11001011 | RES 4,B CB 203 11001011 
BC 140 10001100 AQ 140 10100000 
RES 1,L CB 203 11001011 | RES 4,C CR 203 pola 
8D 141 10001101 Ai 161 10 
RES 2, (HL) CR 203 11001011 | RES 4,D CR 205 toot 
96 150 10010110 az 162 101 
RES 2,(1X+00) DD 221 11011101 | RES 4,E CR 203 too 
CR 203 11001011 AS 165 
00 0 90000000 | RES 4,H oa eos : es 
96 150 10010110 
RES 2,(1¥+00) FD 253 11111101 | RES 4,L ee ae toolas 
CB 203 11001011 
00 9 ooo00000 | RES 5, (HL) CR 205 11001011 
96 150 10010110 AE 174 agit 
‘RES 2,A GB 205 11001011 | RES 5,(1x+00) DD ay See oLt 
By ASL 19010111 
‘RES 2.8 CB 203 11001011 SOOM Sere 
99 144 10010000 AE 174 10 Sates 
CB 203 11001011 | RES 5,(IY+00) FD 253 111 
91 145 10010001 CB 205 11001011 
Sage oo 0 Prrerevererers) 
CH 20S 11001011 
AE 174 10101110 
92 146 10010010 Nae RETIN 
CB 203 11001011 | RES 5,A CB 205 
47 10010011 SF 95 1oiiiit 
ee 187 a CR 2035 1L1do1o1t 
CBR 203 11001011 | RES 5,B 203 


94 148 10010100 AB 168 10101000 


A110 

11109009 
11001009 
11191101 
1001101 
11101104 
91000104 
11001011 
90010110 
11011104 
11001011 


11111101 
11001014 
90000000 


90010110 
11001011 
o0o1e111 
11001011 
90010000 
11001011 
90010001 
11001011 
00010010 
11001011 
90010011 
11001011 
00010100 
11001011 
90010101 
90010111 
11001011 
90000110 
11011101 
11001011 
00000000 
0000110 

p1111101 
11001011 
90000000 


11001011 
‘0000111 
141001011 


pRCLY+00) 


RR A 
RRB 
RRC 
RR D 
RR OE 
RR H 
RRL 
RRA 
RRC (HL) 


RRC(TX+00) 


RRC (TY+00) 


RST 00 

RST 08 

RST 10 

RST 18 

RST 20 

RST 28 

RST 30 

RST 38 

‘SBC A, (HL) 
SBC A, (1x+00) 


SBC A, (IY+00) 


Boo 
a 


ALia1101 
119001011 
00000000 
90011110 
11001011 
oooi11iit 
11001011 
00011000 
1109001011 
00011001 
11001011 
00011010 
11001011 
o0011011 
11001011 
90011100 
11001011 
00011101 
00011111 
11001011 
90001110 
11011101 
11001011 
00000000 
oo001110 
11111101 
11001011 
90000000 
00001110 
11001011 
00001111 
11001011 
00001000 
11001011 
QOO00LOOL 
11001011 
00001010 
11001011 
ooo0o1011 
11001011 
90001100 
11001011 
oo0oe1101 
00001111 
11101101 
01100111 
11000111 
11001111 
11010111 
M1011111 
11100111 
11101111 
11110111 
aniiiii1 
10011110 
11011101 
10011110 
00000000 
11111101 
10011110 
00000000 
10011111 
10011000 
10011001 


SBC A,D 
SBC A,00 


SBC 
SBC 
SBC 
SBC 
SBC HL, DE 
SBC HL,HL 
SBC HL,SP 


SCF 
SET 0, (HL) 


SETO, (1X+00) 
SETO, (1Y+00) 


SETO,A 
SETO,B 
SETO,C 
SETO,D 
SETO,E 
SETO,H 
SETO,L 
SET1, (HL) 


SET1, (1X+00) 
SET1, (1Y+00) 


SET1,A 
SET1,B 
SET1,C 
SET1,D 
SET1,E 
SET1,H 
SETI,L 
SETZ, (HL) 
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90 
DE 
00 
9B 
9c 
9D 
ED 
42 
ED 


Ss2 


154 
222 
o 


155, 
156 
157 
237 
66 
237 
82 
237 
98 
237 
114 
55 
203 
198 
221 
203 
io) 
198 
253 
203 
to) 
35 
203 
199 
203 
192 
203 
193 
203 
194 
203 
195 
203 
196 
203 
197 
203 
206 
221 
203 
oO 
206 
253 
203 
° 
206 
203 
207 
203 
200 
205 
201 
205 
202 
203 
203 
203 
204 
203 
205 
2038 
214 


10011010 
11011110 
90000000 
10011011 
10011100 
10011101 
11101101 
01000010 
11101101 
91010010 
11101101 
91100010 
11101101 
01110010 
00110111 
11001011 
11000110 
11011101 
11001011 
09000000 
11000110 
11111101 
11001011 
90000000 
00100011 
11001011 
11000111 
11001011 
11000000 
11001011 
11000001 
11001011 
11000010 
11001011 
11000011 
11001011 
11000100 
11001011 
11000101 
11001011 
11001110 
11011101 
11001011 
00000000 
11001110 
11111101 
11001011 
0000000 
11001110 
11001011 
11001111 
11001011 
11001000 
11001011 
11001001 
11001011 
11001010 
11001011 
11001011 
11001011 
11001100 
11001011 
11001101 
11001011 
11010110 


11101110 
1100101; 
1110111) 
11001014 
11101009 
110010114 
11101001 
11001011 
11101010 
11001011 
11101011 
11001011 
11101100 
11001011 
11101101 
11001011 
11110110 
11011101 
11001011 
90000000 
11110110 
11111101 
11001011 
Qada0000 
11110110 
11001011 
11110111 
11001011 
11110000 
11001011 
11110001 
11001011 
11110010 
j1og101l 
11110011 


_ 01010000 
01010001 
01010010 
01010011 
01010100 


85 01010101 

: 01010110 

27 39 1 | 87 91010111 
01011000 

: 01011001 

1 01011010 
01011011 

01011100 

5 ti) a 01011101 

a 1 01011110 

2 7 5 1011111 


Other books of interest from Granada: 


THE ZX SPECTRUM 
And How To Get 
The Most From It 
lan Sinclair 

0.246 120185 


THE SPECTRUM 
PROGRAMMER 
S. M. Gee 
0.246 120258 


THE SPECTRUM 
BOOK OF GAMES 
M. James, S. M. Gee 
and K. Ewbank 

(0.246 120479 


THE BBC MICRO— 
AN EXPERT GUIDE 
Mike James 

0.246 120142 


THE COMPLETE 
PROGRAMMER 
Mike James 
0.246 120150 


PROGRAMMING 

WITH GRAPHICS 

Garry Marshall 
0246 12021 5 


SIMPLE INTERFACING 
PROJECTS 


Owen Bishop 
(0.246 12026 6 


COMPUTING FOR 
THE HOBBYIST AND 
SMALL BUSINESS 

A. P. Stephenson 
0.246 12023 | 


COMPUTER 
LANGUAGES AND 
THEIR USES 

Garry Marshall 

0 246 12022 3 


INTRODUCING 
SPECTRUM 
MACHINE CODE 
lan Sinclair 

0 246 120827 


THE DRAGON 32 
And How To Make 
The Most Of It 

lan Sinclair 

0246 121149 


THE DRAGON 32 
BOOK OF GAMES 
M. James, S. M. Gee 
and K Ewbank 

0246 121025 


21 GAMES FOR 

THE BBC MICRO 

M. James, S. M. Gee 
and K’Ewbank 

0246 12103 3 


COMMODORE 64 
COMPUTING 

lan Sinclair 

0 246 12030 4 


2-80 MACHINE 
CODE FOR HUMANS 
Alan Tootill and 
David Barrow 

0 246 1203) 2 


DATABASES FOR 
FUN AND PROFIT 
Nigel Freestone 

0 246 120320 


CHOOSING A 
MICROCOMPUTER 
F. X. Samish 

0 246 120290 


APPLET 
PROGRAMMERS 
HANDBOOK 

R. C. Vile 

0.246 12027 4 


THE ORIC-1 
And How To Get 
The Most From It 
lan Sinclair 

0 246 121300 


THE DRAGON 
PROGRAMMER 
S. M. Gee 

0.246 12133 5 


LYNX COMPUTING 
lan Sinclair 
0.246 121319 


